HIP-4 Outcomes - Order Book

Get HIP-4 L4 orderbook history

Get historical L4 orderbook checkpoint list for a HIP-4 outcome side. Each checkpoint is a full L4 snapshot that can be used as a starting point for replay. The limit parameter defaults to 100 and is capped at 1000. 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/hip4/orderbook/{symbol}/l4/history

Request

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

Path parameters

symbolstring required
Example:0

HIP-4 coin id (e.g., 0 for outcome 0 Yes side, 1 for No side). The #-prefixed form (#0, #1) is also accepted.

Query parameters

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

Start of the requested window. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

integer

Unix milliseconds.

OR
string date-time

RFC 3339 instant.

Example:1767225600000

End of the requested window. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z.

cursorstring

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limitinteger

Maximum number of checkpoints (default: 10, max: 10).

Response

Typed L4 orderbook checkpoint array

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.