v1
latestOpenAPI 3.1.02026-07-265385123.6 KBAccount
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