orderbook_getBook - Historical Order Book

Use orderbook_getBook when you need historical order book state for one Hyperliquid market at a specific block. The parameters intentionally match Dwellir's live Order Book WebSocket subscription shape. For backfills, use orderbook_getBookRange instead of issuing one request per block.

Endpoints

REST:

GET https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/v1/orderbook

JSON-RPC:

POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc

Parameters

l4Book returns the full reconstructed order-level book and does not accept nLevels, nSigFigs, mantissa, or limit.

REST Examples

Historical L2:

curl "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/v1/orderbook?type=l2Book&coin=BTC&blockNumber=985480000&nSigFigs=5&nLevels=20"

Historical BBO:

curl "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/v1/orderbook?type=l2Book&coin=BTC&blockNumber=985480000&nLevels=1"

Historical order-level book:

curl "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/v1/orderbook?type=l4Book&coin=BTC&blockNumber=985480000"

Bulk Range Requests

Range requests keep the same type, coin, nSigFigs, and nLevels parameters and add startBlock, endBlock, pageSize, and cursor pagination. The response envelope matches other Hyperliquid Index range pages:

{
  "data": [
    {
      "type": "l2Book",
      "coin": "BTC",
      "blockNumber": 985450000,
      "bids": [{ "px": "81016", "sz": "1.2", "n": 3 }],
      "asks": [{ "px": "81017", "sz": "0.8", "n": 2 }]
    }
  ],
  "nextCursor": "985451000",
  "hasMore": true
}

Each object in data is one billable returned book. Empty successful pages do not bill, and errors are not charged.

See orderbook_getBookRange for full range parameters and examples.

JSON-RPC Example

curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc" \
  -H "content-type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "orderbook_getBook",
  "params": {
    "type": "l2Book",
    "coin": "BTC",
    "blockNumber": 985480000,
    "nSigFigs": 5,
    "nLevels": 20
  }
}'

Response

REST returns the book object directly. JSON-RPC returns the same object under result.

For l2Book, bids are sorted from highest price to lowest price, and asks are sorted from lowest price to highest price. For l4Book, orders are sorted by side and price, with order ID as the final tie-breaker.

Billing

Single-block orderbook_getBook responses bill as 1 returned book. Range requests bill by the number of book objects in data, not as one flat request. Empty successful range pages and error responses are not charged.