Hyperliquid - Full-Depth L2 Order Book

Get Hyperliquid full-depth L2 order book history

Get paginated full-depth L2 checkpoint snapshots derived from L4 data for Hyperliquid from March 11, 2026 01:03 UTC onward. The route returns full checkpoint depth; it does not currently accept a per-request depth override.

get/v1/hyperliquid/orderbook/{symbol}/l2/history

Request

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

Path parameters

symbolstring required
Example:BTC

Trading pair symbol (e.g., BTC, ETH, SOL)

Query parameters

startinteger
Example:1767225600000

Start timestamp in Unix milliseconds. Defaults to 24h ago.

endinteger
Example:1767229200000

End timestamp in Unix milliseconds. Defaults to now.

cursorinteger

Cursor for pagination (timestamp from previous response's next_cursor)

limitinteger

Maximum number of checkpoint snapshots (default: 100, max: 1000)

Response

Full-depth L2 checkpoint snapshots

successboolean

Example response

{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "timestamp": "2025-01-21T10:30:45.123Z",
      "bids": [
        {
          "px": "42150.00",
          "sz": "1.5",
          "n": 15
        }
      ],
      "asks": [
        {
          "px": "42150.00",
          "sz": "1.5",
          "n": 15
        }
      ],
      "mid_price": "42150.50",
      "spread": "1.00",
      "spread_bps": "2.37",
      "bid_levels": 9842,
      "ask_levels": 10318,
      "total_bid_size": 10234.56,
      "total_ask_size": 9876.54
    }
  ]
}

Changes

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