List Orders
List orders with optional filters.
Returns a paginated list of orders across all accessible subaccounts, ordered by created_at descending.
Filters:
All filters are optional and can be combined. If no subaccount_id is specified,
returns orders from all subaccounts the user has access to.
Order Statuses:
PENDING_SUBMISSION: Order received, awaiting exchange submission.PROCESSING: Being processed by the order consumer.RESTING: Live on the exchange order book (may include partially-filled live orders).EXECUTED: Terminal — fully filled.PARTIALLY_FILLED: Terminal — cancelled with some quantity filled.CANCELLED: Terminal — cancelled with no fills.REJECTED: Rejected by exchange (see order details for reason).
Aggregated Fields:
Each order includes traded_qty, average_price, and fees_paid computed from fills.
Authorizations
UUID of your API key (from Settings → API Keys).
Current unix seconds. Must be within 30s of server time.
Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.
Query Parameters
Filter by order status. Accepts a single OrderStatus name (e.g. 'RESTING') or the meta-value 'ACTIVE' which resolves to RESTING.
Filter by instrument ID
Filter by generic asset ID
Filter to a specific subaccount
Filter to child tranches of a specific iceberg parent.
Filter to child tranches of a specific peg parent.
Filter to IOC children of a specific smart-taker parent.
Filter by direction: true=buys, false=sells
Free-text search across the order's market: ticker/slug, the human-readable question (event title, market name, outcome) via full-text + substring match, plus the order's river_id / order id / generic asset id. Applied server-side over all matching orders, not just the current page.
When true, complex_order_ids only includes attached TP/SL orders with status PENDING or ACTIVE.
Results per page (max 1000)
1 <= x <= 1000Pagination offset
x >= 0
