Hyperliquid Spot - Order Book

Get Hyperliquid Spot order book history

Get historical Hyperliquid Spot L2 order book snapshots for a pair. The route is scoped to Spot pair symbols such as HYPE-USDC; do not use core perp symbols or HIP identifiers. Explicit endpoint cost is 5 credits per request.

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

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/hyperliquid/spot/orderbook/{symbol}/history
  • 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

startinteger

Start timestamp in Unix milliseconds. Defaults depend on the route family.

endinteger

End timestamp in Unix milliseconds. Defaults to now.

cursorstring

Cursor for pagination. Use the value from the previous response metadata.

limitinteger

Maximum number of results (default: 100, max: 1000)

depthinteger
Example:20

Number of price levels per side.

Response

Spot order book 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"
    }
  ]
}

Changes

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