v1

latestOpenAPI 3.0.02026-07-265081124.2 KB
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": "1778155025318314496",
            "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "taker": "0x0000000000000000000000000000000000000000",
            "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
            "makerAmount": "5000000",
            "takerAmount": "10000000",
            "expiration": "0",
            "signatureType": 2,
            "nonce": "0",
            "orderType": "GTC",
            "price": "0.75",
            "ownerId": 12345,
            "market": {
              "id": 7348,
              "slug": "btc-up-or-down-1-hour",
              "title": "BTC Up or Down - Hourly"
            }
          },
          "execution": {
            "matched": true,
            "settlementStatus": "MINED",
            "reason": "STP_TAKER_REJECTED",
            "eligibleAt": "2026-06-08T10:15:30.000Z",
            "tradeEventId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1",
            "txHash": "0xabc123",
            "clientOrderId": "client-order-001",
            "stpMakerCancels": [
              "4aa706dd-6c57-4f3c-945a-99818dfd95f1"
            ],
            "feeRateBps": 25,
            "effectiveFeeBps": 26,
            "totalsRaw": {
              "contractsGross": "1000000",
              "contractsFee": "1000",
              "contractsNet": "999000",
              "usdGross": "500000",
              "usdFee": "500",
              "usdNet": "499500"
            }
          }
        }
      }
    }
  ]
}