Hyperliquid - Orders

Get Hyperliquid trigger levels history

Historical trigger-levels snapshots (15-minute cadence, 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 lists snapshots cheaply without histograms.

get/v1/hyperliquid/orders/{symbol}/trigger-levels/history

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/hyperliquid/orders/{symbol}/trigger-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, items contain snapshot_ts, mid price and totals only (no levels array). 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 trigger levels history

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "levels": [
        {
          "price_bucket": 64200,
          "bid_count": 12,
          "bid_size": 31.25,
          "ask_count": 9,
          "ask_size": 18.75
        }
      ]
    }
  ]
}

Changes

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