List order history
Retrieves historical orders with filtering. Filter by mkt_id, time range (start_ts/end_ts), order status, client order IDs, or order IDs. Supports sorting by created_at or updated_at (ascending/descending via sorted_by). When lmt is omitted or 0, it defaults to 100. Maximum is 1000. If both start_ts and end_ts are provided, end_ts must be greater than start_ts.
Requires authentication.
Authorization
ApiKeyAuth ApiSignatureAuth ApiTimestampAuth API key for authentication
In: header
HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))
In: header
Unix timestamp in seconds
In: header
Query Parameters
Filter by market ID.
Start timestamp in nanoseconds for filtering orders (inclusive). If omitted, no lower bound is applied.
uint64End timestamp in nanoseconds for filtering orders (exclusive). If omitted, no upper bound is applied.
uint64Limit on number of results. Max limit is 1000
int64Filter results by order status.
- ORDER_STATUS_PENDING: Order received, awaiting matching engine processing.
- ORDER_STATUS_OPEN: Order resting on the orderbook.
- ORDER_STATUS_DONE: Order completed (filled or canceled).
- ORDER_STATUS_UNTRIGGERED: Conditional order (stop/TWAP) waiting to be triggered.
Sort the results using the given field. Accepts API field names or DB
column names: crt_ts / created_at (asc), -crt_ts / -created_at
(desc), upd_ts / updated_at (asc), -upd_ts / -updated_at (desc).
Cannot be used together with cursor.
Filter by cl_oids.
Filter by order IDs.
Cursor for keyset pagination (returned as next_cursor in previous response). Uses created_at DESC ordering. Cannot be combined with sorted_by.
Exclude done orders with zero fills (total_filled = 0).
Response Body
application/json