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"

fiat
enum<string>

Fiat by which you want to filter.

Available options:
USD,
MXN,
PEN,
COP
crypto
enum<string>

Crypto by which you want to filter.

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
XLM_USDC_5F3T,
USDC_BASECHAIN_ETH_5I5C,
USDCE_TEMPO_MXYR,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ,
USDT_BSC,
SOL_USDT_EWAY,
EUROC_ETH_F5NG,
EURC_SOL,
EURC_B609K9QB_Y213
side
enum<string>

Side by which you want to filter.

Available options:
buy,
sell
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

fees
object

Object containing detailed information about various fees

destinationOfFunds
object

Details about the destination of funds

quoteId
string

The ID of the quote

Example:

"6660be85d6c964829d63fd05"

userId
string

The ID of the user

Example:

"65a99abb6a92bda6e52bf7af"

status
enum<string>

The status of the order. These are the statuses an order moves through on a normal flow, and which ones it sees depends on whether it is a buy or a sell and on whether payment is deferred. 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
crypto
enum<string>

The type of cryptocurrency used

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
XLM_USDC_5F3T,
USDC_BASECHAIN_ETH_5I5C,
USDCE_TEMPO_MXYR,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ,
USDT_BSC,
SOL_USDT_EWAY,
EUROC_ETH_F5NG,
EURC_SOL,
EURC_B609K9QB_Y213
side
enum<string>

The side of the order

Available options:
buy,
sell
fiat
enum<string>

The type of fiat currency used

Available options:
USD,
MXN,
PEN,
COP
createdAt
string

The date and time the order was created

Example:

"2024-06-05T19:38:20.264Z"

country
enum<string>

The country of the user

Available options:
MX,
PE,
CO
amountFiat
number

The total amount in fiat currency involved in the transaction

Example:

1000

amountCrypto
number

The total amount of cryptocurrency involved in the transaction

Example:

55.54

marketPrice
number

The price of the cryptocurrency

Example:

0.0568673040717

netPrice
number

The net price of the cryptocurrency

Example:

0.05554

notes
string

Additional information or comments related to the order

Example:

"Description Pt.1"

payoutBankAccountId
string

The unique identifier of the bank account to which the payout will be sent

Example:

"660c10c6eb4fbb235708b8e8"

expiredQuotes
string[]

Array of identifiers for quotes that have expired

cryptoAddress
string

The blockchain address for the cryptocurrency transaction

Example:

"0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C"

id
string

The unique identifier for the order

Example:

"6660beaccc4633bc6412318a"

payoutAddressId
string

The unique identifier of the payout address

Example:

"673b5cf6302b8444c78dd3d3"

attributes
string[]

List of attributes associated with the order

Example:
payoutTransferLimit
number

The limit for payout transfer

Example:

475000

paymentsReceived
object[]

List of payments received

payoutsSent
object[]

List of payouts sent

paymentInstructions
object

Account information for the bank to which funds will be sent to in a buy order or the blockchain address the funds will be sent to in a sell order

paymentReceivedAt
string

The date and time the payment was received

Example:

"2025-01-10T13:14:42.855Z"

invoice
object

order invoice details, only applies to Mexican orders.

informationalFees
object

Informational fees for the order (does not affect quote)

twoWaySettlementType
enum<string>

The type of settlement for the order. default means that the order is settles regularly (usually this means upon receipt of the payment), while TPlusOffset means that the order is settled after a certain number of business days.

Available options:
default,
TPlusOffset
twoWaySettlementDateOffset
number

The number of business days until the order is settled. This is only applicable for if the twoWaySettlementType is TPlusOffset.

Example:

1

twoWaySettlementDate
string

The date on which the order is settled.

Example:

"2024-06-04T15:02:13.097Z"

effectiveTwoWaySettlementDateOffset
number

The number of billable days until the order is settled. This is only applicable for if the twoWaySettlementType is TPlusOffset.

Example:

1

type
enum<string>

The type of order. market means that the order is executed at the current market price, while limit means that the order is executed at a specified limit net price.

Available options:
market,
limit
limitNetPrice
number

The net price of the order. This is only applicable for if the order type is limit.

Example:

18.75

timeInForceStartsAt
string

The date and time from which the order is scheduled to be executed (optional).

Example:

"2024-06-04T15:02:13.097Z"

timeInForceEndsAt
string

The date and time until which the order is scheduled to be executed (optional).

Example:

"2024-06-04T15:02:13.097Z"

parentOrderId
string

The ID of the parent order. This is only applicable for if the order was spawned from a partial fill.

Example:

"6660beaccc4633bc6412318a"