Hyperliquid - Order Book

Get Hyperliquid native L2 order book (20 levels)

Get the latest venue-native Hyperliquid L2 order book snapshot, or a snapshot at a specific timestamp. This native route is capped at the 20 price levels per side provided by Hyperliquid source snapshots. Use /v1/hyperliquid/orderbook/{symbol}/l2 for full-depth aggregated L2 derived from L4.

get/v1/hyperliquid/orderbook/{symbol}

Request

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

Path parameters

symbolstring required
Example:BTC

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

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Instant to read. If not provided, returns latest snapshot. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

depthinteger
Example:20

Requested price levels per side for this native venue snapshot. Hyperliquid native L2 data is capped at 20 levels per side; values above 20 do not return full depth on this route. Use the /l2 routes for full-depth aggregated L2.

Response

Order book snapshot

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"
  },
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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