Hyperliquid Spot

Get Hyperliquid Spot L4 order book

Get the L4 order-level reconstruction checkpoint for a Hyperliquid Spot pair. Within each price level, bids and asks are ordered by true queue priority (ALO priority insertions included), not by placement time. Depth truncation is by order count, so the orders at a depth cut can differ from responses served before 2026-07-21.

get/v1/hyperliquid/spot/orderbook/{symbol}/l4

Request

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

Path parameters

symbolstring required
Example:HYPE-USDC

Hyperliquid Spot pair symbol, for example HYPE-USDC

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Instant of the Hyperliquid Spot snapshot. If omitted, returns the latest snapshot. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

depthinteger
Example:20

Maximum number of resting orders retained per side for this Hyperliquid Spot L4 snapshot. Omit for the full stored depth.

Response

Typed L4 orderbook snapshot

successboolean required

Example response

{
  "success": true,
  "data": {
    "coin": "BTC",
    "timestamp": "2026-03-12T00:00:00.000Z",
    "checkpoint_timestamp": "2026-03-12T00:00:00.000Z",
    "last_block_number": 1023882395,
    "bids": [
      {
        "oid": 18499128731,
        "user_address": "0x0000000000000000000000000000000000000000",
        "side": "B",
        "price": 105384.5,
        "size": 0.824,
        "timestamp": 1773273600123,
        "timestamp_ms": 1767225600000
      }
    ],
    "asks": [
      {
        "oid": 18499128731,
        "user_address": "0x0000000000000000000000000000000000000000",
        "side": "B",
        "price": 105384.5,
        "size": 0.824,
        "timestamp": 1773273600123,
        "timestamp_ms": 1767225600000
      }
    ],
    "bid_count": 12,
    "ask_count": 15,
    "total_bid_size": 102.34,
    "total_ask_size": 98.76,
    "is_crossed": true
  },
  "meta": {
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

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