Skip to main content
GET
Get orders

Requirements to consume the endpoint.

User approved

The user must be approved in at least one country.

Retrieving several orders at once

Use the ids parameter to fetch up to 50 specific orders in a single request instead of calling GET /api/orders/{id} once per order. Separate the ids with commas.
If you are polling order statuses, prefer this over one request per order. It is faster for you and it keeps response times stable for everyone.
When ids is present and limit is not, the limit defaults to the number of ids you sent, so a single page returns all of them. If you also pass limit, that value wins and the results are paginated as usual.
Ids you are not authorized to see are simply not returned, so a response may contain fewer orders than the number of ids you sent. The same applies to ids that do not exist or that fall outside the other filters you sent in the request. Invalid ids, or more than 50 of them, are rejected with a validation error.

Authorizations

x-api-key
string
header
required

Query Parameters

userId
string

User id by which you want to filter.

Example:

"665f4084b96e4fb76f5a0e0c"

brokerId
string

Broker id by which you want to filter.

Example:

"655f4084b96e4fb76f5a0e6e"

quoteId
string

Quote id by which you want to filter.

Example:

"765f4084b96e4fb76f5a4fb0"

startDate
string

Start date by which you want to filter.

Example:

"2024-01-15"

endDate
string

End date by which you want to filter.

Example:

"2024-05-30"

asset
enum<string>

Return orders where either leg is this asset.

Available options:
USD,
MXN,
PEN,
COP,
USDC,
USDCe,
EURC,
USDT
network
enum<string>

Narrow asset to one network. Requires asset.

Available options:
ethereum,
polygon,
solana,
stellar,
base,
tempo,
tron,
bsc
flow
enum<string>

Return orders of one flow.

Available options:
fiatToCrypto,
cryptoToFiat,
cryptoToCrypto
status
enum<string>

Status by which you want to filter. These are the statuses an order moves through on a normal flow, and other statuses can be filtered on depending on the circumstances of the order.

Available options:
awaitingTimeInForceToStart,
awaitingLimitPriceCondition,
timeInForceEnded,
created,
addressCheckPassed,
awaitingPayment,
processing,
paid,
incorrectAmountPaid,
sourcingLiquidity,
liquiditySourced,
filled,
complete,
depositAddressCreated,
awaitingBankPayoutDetails,
bankPayoutDetailsAdded,
depositConfirmed,
awaitingPayout,
bankPaymentDetailsAdded,
awaitingAsyncPayment,
awaitingAsyncPayout,
cancelled,
expired
country
enum<string>

Country by which you want to filter.

Available options:
MX,
PE,
CO
page
integer

Used to specify the current page you want to get in the paging results.

limit
integer

Used to specify the maximum number of records to be returned on a single page.

clientReferenceId
string

Client reference ID by which you want to filter. Maximum length: 100 characters.

Maximum string length: 100
Example:

"03d5ec9af663fbd39a1fa"

ids
string

Comma separated list of order ids to retrieve in a single request. Up to 50 ids. Combines with the other filters and only returns orders you are authorized to see.

Example:

"b49f4084b96e4fb76f5a496e,765f4084b96e4fb76f5a4fb0"

Response

OK

id
string

Id of the order.

Example:

"6660bdefd6c964829d63fcb8"

quoteId
string

Id of the quote the order is priced on. Changes when the order is re-quoted.

Example:

"6660bdefd6c964829d63fcb7"

userId
string

Id of the user the order belongs to.

Example:

"66290ac8bd3903485989f82e"

clientReferenceId
string

Your own reference for the order.

Example:

"my-reference-1234"

status
enum<string>

Current status. These are the statuses an order moves through on a normal flow. Which ones it sees depends on the flow. Other statuses can appear depending on the circumstances of the order.

Available options:
awaitingTimeInForceToStart,
awaitingLimitPriceCondition,
timeInForceEnded,
created,
addressCheckPassed,
awaitingPayment,
processing,
paid,
incorrectAmountPaid,
sourcingLiquidity,
liquiditySourced,
filled,
complete,
depositAddressCreated,
awaitingBankPayoutDetails,
bankPayoutDetailsAdded,
depositConfirmed,
awaitingPayout,
bankPaymentDetailsAdded,
awaitingAsyncPayment,
awaitingAsyncPayout,
cancelled,
expired
Example:

"awaitingPayment"

flow
enum<string>

Direction of the conversion, derived from the two assets. fiatToCrypto buys stablecoins, cryptoToFiat sells them, cryptoToCrypto swaps one stablecoin or network for another.

Available options:
fiatToCrypto,
cryptoToFiat,
cryptoToCrypto
Example:

"fiatToCrypto"

origin
object

What the customer pays. The amount is in the leg's own asset.

destination
object

What the customer receives. The amount is in the leg's own asset.

fixedLeg
enum<string>

Which leg's amount you specified. The other leg was derived from the price and fees.

Available options:
origin,
destination
Example:

"origin"

pricingDetails
object

How the destination amount was derived from the origin amount.

settlement
object

How and when the two legs settle.

marketPrice
number

Market price at the time the order was created, in units of the destination asset per unit of the origin asset.

Example:

0.056

netPrice
number

Final price including fees and taxes.

Example:

0.05476

type
enum<string>

market executes at the current price, limit waits for limitNetPrice.

Available options:
market,
limit
Example:

"market"

limitNetPrice
number

Limit price for limit orders, expressed like netPrice as units of the destination asset per unit of the origin asset. Only applicable when orderType is limit.

Example:

0.0555

timeInForceStartsAt
string<date-time>

Earliest execution time of a limit order.

Example:

"2026-10-12T18:00:00.000Z"

timeInForceEndsAt
string<date-time>

Latest execution time of a limit order.

Example:

"2026-10-12T18:00:00.000Z"

attributes
string[]

List of attributes associated with the order.

Example:
notes
string

Notes you attached to the order.

Example:

"Note"

payoutTransferLimit
number

Maximum amount per payout transfer. Larger payouts are split.

Example:

475000

paymentReceivedAt
string<date-time>

When your payment was received.

Example:

"2026-10-12T18:00:00.000Z"

expiredQuotes
string[]

Ids of quotes the order went through before the current one.

Example:
parentOrderId
string

Id of the parent order when this order was spawned from a partial fill.

invoice
object

Invoice details, Mexican orders only.

informationalFees
object

Informational fees (do not affect the quote).

createdAt
string<date-time>

Creation time.

Example:

"2026-10-12T18:00:00.000Z"