---
title: "Get order statuses in batch"
method: POST
path: "/orders/status/batch"
tags: ["Trading"]
---

# Get order statuses in batch

`POST /orders/status/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.

## Request body

- BatchOrderStatusRequestDto
  - `items` BatchOrderStatusItemDto[], required — List of status lookup queries (1-50 items)
    - `orderId` string, uuid — Internal order ID. Provide either orderId or clientOrderId, not both.
    - `clientOrderId` string — Client-provided order ID. Provide either orderId or clientOrderId, not both.

## Response `200`

Batch order statuses

- BatchOrderStatusResponseDto
  - `results` BatchOrderStatusResultDto[], required — Array of status results corresponding to request items
    - `index` number, required — Index of this item in the request array
    - `status` 'found' | 'not_found' | 'invalid', required — Lookup result status
    - `error` string, nullable — Error message if status is 'invalid'
    - `orderId` string, nullable — Resolved internal order ID
    - `clientOrderId` string, nullable — Client-provided order ID
    - `data` object, nullable — Order data if found
      - `order` OrderResponseDto
        - `order` Order, required
          - `salt` number, required — Unique random value for signature uniqueness (prevents replay attacks)
          - `maker` string, required — Ethereum address of the maker (order creator)
          - `signer` string, required — Address that signed the order
          - `taker` string — Specific taker address (optional for open orders)
          - `tokenId` string, required — Token ID being traded (YES or NO position ID from conditional token)
          - `makerAmount` number, required — Amount the maker is offering, scaled by 1e6. For GTC orders: price * size * 1e6 (BUY) or size * 1e6 (SELL). For FOK orders: USDC to spend * 1e6 (BUY) or shares to sell * 1e6 (SELL).
          - `takerAmount` number, required — Amount the maker wants in return, scaled by 1e6. For GTC orders: size * 1e6 (BUY) or price * size * 1e6 (SELL). For FOK orders: always 1.
          - `expiration` string — Order expiration timestamp
          - `nonce` number — Order nonce for cancellation tracking
          - `price` number — Order price as decimal (0.01-0.99, required for GTC orders)
          - `feeRateBps` number, required — Fee rate in basis points (1% = 100)
          - `side` 0 | 1, required — Order side: 0 = BUY, 1 = SELL
          - `signature` string — EIP-712 signature of order details. Optional when using delegated signing.
          - `signatureType` 0 | 1 | 2 | 3 — Signature type (0-3). Optional when using delegated signing.
        - `makerMatches` MakerMatch[] — Maker matches if order was matched immediately
        - `execution` OrderExecutionDto, required — Execution and settlement summary for a created order
          - `matched` boolean, required — Whether the order was matched immediately
          - `settlementStatus` 'UNMATCHED' | 'MATCHED' | 'MINED' | 'CONFIRMED' | 'RETRYING' | 'FAILED', required — Current settlement status of the order
          - `tradeEventId` string — Trade event ID (present when matched)
          - `txHash` string, nullable — On-chain transaction hash (present when mined)
          - `clientOrderId` string — Echo of client-provided idempotency key
          - `feeRateBps` number, required — Fee rate in basis points applied to this order
          - `effectiveFeeBps` number, required — Effective fee rate in basis points after any rebates
          - `totalsRaw` OrderExecutionTotalsRawDto, required — Raw execution totals in contract units (strings to preserve precision)
            - `contractsGross` string, required
            - `contractsFee` string, required
            - `contractsNet` string, required
            - `usdGross` string, required
            - `usdFee` string, required
            - `usdNet` string, required
      - `makerMatches` MakerMatch[] — Maker orders matched against this order
      - `execution` OrderExecutionSummary
        - `clientOrderId` string, nullable — Client-provided order ID if one was set
        - `feeRateBps` number — Fee rate in basis points
        - `effectiveFeeBps` number — Effective fee rate after rebates
        - `matched` boolean — Whether the order was matched with a counterparty
        - `settlementStatus` 'UNMATCHED' | 'PENDING' | 'MINED' | 'CONFIRMED' | 'FAILED' — On-chain settlement status
        - `tradeEventId` string, nullable — Trade event ID if matched
        - `txHash` string, nullable — Transaction hash on Base L2
        - `totalsRaw` object — Raw execution totals as strings (to preserve precision)
          - `contractsGross` string
          - `contractsFee` string
          - `contractsNet` string
          - `usdGross` string
          - `usdFee` string
          - `usdNet` string

## Other responses

- `400` — Invalid request body
- `401` — User not authenticated

## Changes

- **2026-03-26** `7583da44d16b` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `bearer` was removed from the API
- **2026-03-24** `850283168331` — 2 breaking, 1 info
  - the response property `results/items/data/order/order/allOf[#/components/schemas/Order]/signature` became optional for the status `200`
  - the response property `results/items/data/order/order/allOf[#/components/schemas/Order]/signatureType` became optional for the status `200`
  - added the required property `results/items/data/order/execution` to the response with the `200` status
- **2026-03-09** `57db5c3f80ff` — 2 info
  - the endpoint scheme security `bearer` was added to the API
  - the endpoint scheme security `limitless_session` was removed from the API
- **2026-03-09** `14ee5879de6b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/changes/orders/status/batch/post.md)

---

[API](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api.md) · [All operations](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/revisions/20e1fd747a5c?raw)