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

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Range start, inclusive. Default: 24 hours before end. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Range end, inclusive. Default: now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page. 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,
  "data": [
    {
      "snapshot_ts_ms": 1767225600000
    }
  ],
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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