v1
latestOpenAPI 3.1.02026-07-2681217214.1 KBGet liquidations
Historical liquidations feed for a perpetual market, newest first, with cursor pagination. Query window capped at 7 days per request.
get/api/v1/markets/{market_id}/perps/liquidations
Path parameters
market_idstring required
Canonical market slug, {venue}:{instrument_type}:{pair}.
Query parameters
start_timestampstring required
Start of the window (ISO 8601; naive datetimes treated as UTC).
end_timestampstring required
End of the window (ISO 8601).
limitinteger
Maximum rows to return (1–5000).
cursorstring
Pagination cursor from a previous response. Format: {ts_ms}_{id}.
Response
Liquidation events.
Example response
{
"items": [
{
"market_id": "hl:perp:BTC-USDC",
"ts": "2026-05-01T13:21:04.512000+00:00",
"size_base": "1.2500",
"price": "103420.00",
"notional_usd": "129275.00"
}
]
}