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

Changes

Changed in 10 of the 32 revisions of this API.5435

Jun 12, 2026da9b369e16fd2See the full diff
- ○
  the endpoint scheme security HmacAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security ApiKeyAuth was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 10, 202613f1d7979a9622See the full diff
- ●
  added the new CANCELED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new CANCELED enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Jun 9, 20266591926f3cef1See the full diff
- ▲
  the ///// response's property format changed from date-time to no format for status
  response-property-type-changed
Jun 8, 202655779d111c8022See the full diff
- ●
  added the new DELAYED enum value to the //// response property for the response status
  response-property-enum-value-added
- ●
  added the new DELAYED enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
May 22, 2026fe10b36da379123See the full diff
- ▲
  the //// response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  removed from the //// response property allOf list for the response status
  response-property-all-of-removed
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
- ○
  added the required property ///// to the response with the status
  response-required-property-added
May 21, 20265e9b7db6b0db1See the full diff
- ▲
  response property results/items/data/order/order/allOf[Order]/salt list-of-types was widened by adding types string to media type application/json of response 200
  response-property-list-of-types-widened
Mar 26, 20267583da44d16b2See the full diff
- ○
  the endpoint scheme security ApiKeyAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security bearer was removed from the API
  api-security-removed
Mar 24, 202685028316833121See the full diff
- ▲
  the response property ///////// became optional for the status
  response-property-became-optional
- ▲
  the response property ///////// became optional for the status
  response-property-became-optional
- ○
  added the required property //// to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 9, 202657db5c3f80ff2See the full diff
- ○
  the endpoint scheme security bearer was added to the API
  api-security-added
- ○
  the endpoint scheme security limitless_session was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 9, 202614ee5879de6b1See the full diff
- ○
  endpoint added
  endpoint-added

Full history