Skip to main content

Basic flow

The typical API usage flow follows three steps:
1

Get a quote

Request a quote for the desired pair with the operation amount.
2

Create an order

Use the returned quoteId to create a buy order within 5 seconds.
3

Track

Check the order status and track the cryptocurrency delivery.

1. Get a quote

curl -X GET "https://api.pixusglobal.com/client/quote?symbols=USDTBRL&amount=1000" \
  -H "Authorization: Bearer your-token"
Response:
{
  "symbol": "USDTBRL",
  "price": "5.42",
  "totalCost": "5420.00",
  "totalFilled": "1000",
  "quoteId": "q_abc123",
  "expiresIn": 1755097046
}
Quotes expire in 5 seconds. Create the order immediately after receiving the quoteId. Expired quotes return a 400 error.

2. Create an order

curl -X POST "https://api.pixusglobal.com/client/order" \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{ "quoteId": "q_abc123" }'
Response:
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 1000,
  "symbol": "USDTBRL",
  "price": "5.4200",
  "side": "BUY",
  "timestamp": "2025-01-15T14:30:00.000Z"
}

3. Check order status

curl -X GET "https://api.pixusglobal.com/client/orders/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer your-token"

4. Track cryptocurrency delivery

curl -X GET "https://api.pixusglobal.com/client/orders/550e8400-e29b-41d4-a716-446655440000/tracking" \
  -H "Authorization: Bearer your-token"

Next steps