Hyperliquid - Liquidations

Get Hyperliquid liquidation levels history

Historical liquidation-levels snapshots (about every 5 minutes, retained from 2026-07-27), ascending by snapshot_ts. Cursor pagination: pass start/end/limit and follow meta.next_cursor as the cursor parameter. summary=true omits only levels while retaining snapshot_ts, block_number, mid_price, total_long, total_short, and flagged_notional.

get/v1/hyperliquid/liquidations/{symbol}/levels/history

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/hyperliquid/liquidations/{symbol}/levels/history
  • Auth: API key in header X-API-Key

Path parameters

symbolstring required
Example:BTC

Trading pair symbol.

Query parameters

startinteger

Range start, epoch milliseconds inclusive. Default: 24 hours before end.

endinteger

Range end, epoch milliseconds inclusive. Default: now.

cursorstring

Cursor from meta.next_cursor of the previous page (a snapshot_ts in epoch milliseconds, exclusive). The page continues strictly after it.

limitinteger

Snapshots per page. Default 24, maximum 100. When a page is full, meta.next_cursor carries the cursor for the next page.

summaryboolean

When true, omits only levels while retaining snapshot_ts, block_number, mid_price, total_long, total_short, and flagged_notional. Cheap way to discover which snapshots exist before fetching full histograms.

range_pctnumber

Percentage range around the snapshot mid/mark price. Clamped between 1 and 50. Default 10.

bucketsinteger

Number of price buckets. Clamped between 10 and 200. Default 50.

side'bid' | 'ask' | 'buy' | 'sell' | 'B' | 'A'

Optional side filter. bid/buy/B keeps the long (or bid) side, ask/sell/A keeps the short (or ask) side; the other side is zeroed.

Response

Get Hyperliquid liquidation levels history

successboolean

Example response

{
  "success": true
}

Changes

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