Orders

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). Maximum 1000 orders per request (lmt).

Requires authentication.

GET
/orders/history

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth
x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Query Parameters

mkt_id?string

Filter by market ID.

start_ts?string

Filter by minimum posted UNIX timestamp in nanoseconds.

Formatuint64
end_ts?string

Filter by maximum posted UNIX timestamp in nanoseconds.

Formatuint64
lmt?integer

Limit on number of results. Max limit is 1000

Formatint64
statuses?array<>

Filter 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.
sorted_by?string

Sort the results using the given field. Supported values :created_at (sort by created_at asc), -created_at (sort by created_at desc), updated_at (sort by updated_at asc), -updated_at (sort by updated_at desc).

cl_oids?array<>

Filter by cl_oids.

oids?array<>

Filter by order IDs.

Response Body

application/json