Trading

Get orders

Retrieve a paginated list of orders with optional filtering by account, provider, status, and time range.

Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

For detailed information about error codes and troubleshooting, please refer to our API Error Codes documentation.

get/trading/orders

Request

Query parameters

pageSizeinteger required

pageSize for pagination.

pageCursorstring
order'ASC' | 'DESC'

ASC / DESC ordering (default DESC)

accountIdstring[]

Filter by accountId.

providerIdstring[]

Filter by providerId.

statusesOrderStatus[]

Filter by order status.

[
  "PROCESSING"
]
startTimeinteger
endTimeinteger
assetConversionType'DIGITAL_ONLY' | 'FIAT'

Filter by asset conversion type.

Response

Orders response

totalinteger required

Total number of orders matching the query.

nextstring

A cursor for the next page of results, if available.

Example response

{
  "data": [
    {
      "id": "ord_5f8e2d9c1a7b4e36",
      "via": {
        "type": "PROVIDER_ACCOUNT",
        "providerId": "prov_8c3f1a4b2d6e9f7c",
        "accountId": "acc_5e9a2d1c4b7f3e8a"
      },
      "baseAmount": "1000.00",
      "quoteAmount": "0.02458",
      "baseAssetId": "USD",
      "quoteAssetId": "BTC",
      "status": "COMPLETED",
      "destination": {
        "type": "VAULT_ACCOUNT",
        "accountId": "vault_acc_7b2e5d8f1c4a9e3b"
      },
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "total": 1,
  "next": "cursor_next_page_token"
}

Changes

No recorded changes to this operation across all 1 revision of this API.