Account

Get user order history

Retrieve paginated order history for a specific user including filled, cancelled, and expired orders. Supports filtering by market, order type, status, side, reduce-only, and timestamp range. Supports sorting by timestamp (default: descending). Page size is capped at 200.

get/api/v1/order_history

Query parameters

accountstring required

User account address (user query alias is also accepted)

limitinteger

Page size

offsetinteger

Page offset

start_timestampinteger

end_timestampinteger

sort_key'timestamp'

Sort key for history endpoints

sort_dir'ASC' | 'DESC'

marketstring

Filter by market address

order_typestring

Filter by order type

statusstring

Filter by order status

side'buy' | 'sell'

Order side filter: buy (long) or sell (short). For orders, maps to is_buy column. For trades/funding, maps to action IN ('OpenLong','CloseShort') (buy) or action IN ('CloseLong','OpenShort') (sell).

Filter by side

reduce_onlyboolean

Filter by reduce-only flag

Response

Order history retrieved successfully

total_countinteger nullable

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Changes

No recorded changes to this endpoint across all 1 revision of this API.