Get orders

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

Note:These endpoints are currently in beta and might be subject to changes.

If you want to participate and learn more about the Fireblocks Trading, please contact your Fireblocks Customer Success Manager or send an email to [e-mail].

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

TypeScript

TypeScript

const response: Promise<FireblocksResponse<GetOrdersResponse>> = fireblocks.tradingBeta.getOrders(tradingBetaApiGetOrdersRequest);

200

{
  "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"
}

Query Parameters

pageSize · integer · required

pageSize for pagination.

Required range: 1 <= x <= 100

pageCursor · string

Minimum string length: 1

order · enum<string> · default: DESC

ASC / DESC ordering (default DESC)

Available options: ASC, DESC

accountId · string[]

Filter by accountId.

Minimum string length: 1

providerId · string[]

Filter by providerId.

Minimum string length: 1

statuses · enum<string>[]

Filter by order status.

Available options: CREATED, AWAITING_PAYMENT, PENDING_USER_ACTION, PROCESSING, CANCELED, COMPLETED, FAILED

startTime · integer

Required range: x >= 0

endTime · integer

Required range: x >= 0

assetConversionType · enum<string>

Filter by asset conversion type.

Available options: DIGITAL_ONLY, FIAT

Response

200

application/json

Orders response

data · object[] · required

Show child attributes

total · integer · required

Total number of orders matching the query.

next · string

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