GET
/
api
/
orders
Get orders
curl --request GET \
  --url https://app.sandbox.rio.trade/api/orders \
  --header 'x-api-key: <api-key>'
[
  {
    "fees": {
      "processingFeeFiat": 0,
      "transferFeeFiat": 0.17584797034499297,
      "platformFeeFiat": 20
    },
    "destinationOfFunds": {
      "blockchainAddress": "TS9kqAVq4PR7xNoQDJXSP6Kgz8GFbwUbzi",
      "accountHolderName": "John Doe",
      "accountNumber": "1234567890",
      "CCI": "00111233001112345678",
      "CLABE": "014027000000000008"
    },
    "quoteId": "6660be85d6c964829d63fd05",
    "userId": "65a99abb6a92bda6e52bf7af",
    "status": "created",
    "crypto": "USDC",
    "side": "buy",
    "fiat": "USD",
    "createdAt": "2024-06-05T19:38:20.264Z",
    "country": "MX",
    "amountFiat": 1000,
    "amountCrypto": 55.54,
    "marketPrice": 0.0568673040717,
    "netPrice": 0.05554,
    "notes": "Description Pt.1",
    "payoutBankAccountId": "660c10c6eb4fbb235708b8e8",
    "expiredQuotes": [
      "<string>"
    ],
    "USBankTransferMethod": "ach_push",
    "cryptoAddress": "0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C",
    "id": "6660beaccc4633bc6412318a",
    "payoutAddressId": "673b5cf6302b8444c78dd3d3",
    "attributes": [
      "fixedPrice"
    ],
    "payoutTransferLimit": 475000,
    "paymentsReceived": [
      {
        "amount": 100000,
        "accountHolderName": "John Doe",
        "accountNumber": null,
        "CCI": null,
        "CLABE": "123456789012345678",
        "receivedAt": "2025-01-10T13:14:42.855Z"
      }
    ],
    "payoutsSent": [
      {
        "amount": 4748.36,
        "blockchainTxId": "0x66ECBd38905CC32249ddd6f4f0B4A3DdDDCbd608",
        "sentAt": "2025-01-10T13:14:48.240Z",
        "SPEITrackingNumber": "<string>",
        "CEPLink": "<string>",
        "reference": "<string>"
      }
    ],
    "paymentInstructions": {
      "dueDate": "2024-06-04T15:02:13.097Z",
      "bankName": "Bank Name",
      "companyName": "Company Name",
      "companyAddress": "Company Address",
      "bankAddress": "Sandbox Bank Address, 12345, Sandbox City, Sandbox Country",
      "accountNumber": "<string>",
      "routingNumber": "123456789",
      "reference": "9f5676",
      "CLABE": "01212345678901",
      "RUC": "<string>",
      "RFC": "RBL123456789",
      "CCI": "00111233001112345678",
      "blockchainAddress": "0xAf56edF88c429F1D6858f9E47731FF53F6d34D0C"
    },
    "paymentReceivedAt": "2025-01-10T13:14:42.855Z",
    "invoice": {
      "PDFLink": "<string>",
      "XMLLink": "<string>"
    },
    "informationalFees": {
      "serviceFeeFiat": 0,
      "serviceFeeFiatTax": 0
    },
    "twoWaySettlementType": "default",
    "twoWaySettlementDateOffset": 1,
    "twoWaySettlementDate": "2024-06-04T15:02:13.097Z",
    "effectiveTwoWaySettlementDateOffset": 1,
    "type": "market",
    "limitNetPrice": 18.75,
    "timeInForceStartsAt": "2024-06-04T15:02:13.097Z",
    "timeInForceEndsAt": "2024-06-04T15:02:13.097Z",
    "parentOrderId": "6660beaccc4633bc6412318a"
  }
]

​
Requirements to consume the endpoint.

User approved

The user must be approved in at least one country.

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
​
crypto
enum<string>

Crypto by which you want to filter.

Available options:
USDC,
USDC_POLYGON_NXTB,
SOL_USDC_PTHX,
USDT_POLYGON,
USDT_ERC20,
TRX_USDT_S2UZ
​
side
enum<string>

Side by which you want to filter.

Available options:
buy,
sell
​
status
enum<string>

Status by which you want to filter.

Available options:
created,
cancelled,
processing,
sourcingLiquidity,
cryptoAddressAdded,
liquiditySourced,
awaitingBankPayoutDetails,
awaitingBinanceSettlement,
binanceSettlementFailed,
incorrectBinanceSettlement,
depositRegistered,
depositConfirmed,
paymentOriginMismatch,
paid,
filled,
refundInitiated,
addressCheckPassed,
depositAddressCreated,
complete,
failedPayment,
bankPayoutDetailsAdded,
awaitingPayment,
awaitingOriginOrderCompletion,
awaitingTransferReissue,
awaitingPayout,
awaitingAsyncPayout,
awaitingAsyncPayment,
awaitingBridgeRouting,
failedFill,
failedTransfer,
failedQuote,
failedProcessorRouting,
failedLiquidityRouting,
failedFees,
incorrectAmountPaid,
insufficientLiquidityFailed,
depositAddressFailed,
addressCheckFailed,
refundFailed,
refundComplete,
bridgeOrderCreationFailed,
bridgeOrderRoutingFailed,
bridgeTransferFailed,
depositAmountMismatchFailed,
failedUnknown,
expired
​
country
enum<string>

Country by which you want to filter.

Available options:
MX,
PE,
US
​
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.

Response

200
application/json

OK

The response is of type object[].