v1
latestOpenAPI 3.1.02026-07-26399062.0 KBapi-gateway
Returns historical liquidations for the authenticated user. Requires an explicit time range: both start_timestamp_ns and end_timestamp_ns must be provided and span no more than 7 days. Missing, inverted, or wider ranges are rejected with a 400.
get/liquidations
Query parameters
account_idstring nullable
Optional account ID. If omitted, default (primary) user account is used.
symbolstring nullable
Optional symbol filter. If provided, only fills for this symbol will be returned.
end_timestamp_nsinteger nullable
start_timestamp_nsinteger nullable
cursorstring nullable
limitinteger nullable
sort_ts'asc' | 'desc'
Sort order/direction.
- asc: ascending order per field type (e.g. lexicographic, numeric, etc.)
- desc: descending order per field type
Response
List of liquidations