Sign in
Trading

Get order statuses in batch

Fetches historical order statuses for multiple orders by internal order IDs and/or client-provided order IDs. Returns execution details, settlement status, and maker match data for each order.

post/orders/status/batch

Request body

Example request

{
  "items": [
    {
      "orderId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1",
      "clientOrderId": "client-order-001"
    }
  ]
}

Response

Batch order statuses

Example response

{
  "results": [
    {
      "status": "found",
      "error": "Exactly one of orderId or clientOrderId is required",
      "data": {
        "order": {
          "order": {
            "salt": 1234567890,
            "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "taker": "0x0000000000000000000000000000000000000000",
            "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
            "makerAmount": 5000000,
            "takerAmount": 10000000,
            "expiration": "2025-04-30T23:59:59Z",
            "nonce": 42,
            "price": 0.75,
            "signature": "0x123abc456def789ghi0123abc456def789ghi0123abc456def789ghi0123456789012345678901",
            "signatureType": 2
          },
          "execution": {
            "matched": true,
            "settlementStatus": "MINED",
            "tradeEventId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1",
            "txHash": "0xabc123",
            "clientOrderId": "client-order-001",
            "feeRateBps": 25,
            "effectiveFeeBps": 26,
            "totalsRaw": {
              "contractsGross": "1000000",
              "contractsFee": "1000",
              "contractsNet": "999000",
              "usdGross": "500000",
              "usdFee": "500",
              "usdNet": "499500"
            }
          }
        }
      }
    }
  ]
}

Changes