HIP-4 Outcomes - Order Book

Get HIP-4 L4 orderbook

Get the full L4 (individual order-level) orderbook reconstruction for a HIP-4 outcome side. Returns the latest snapshot if no timestamp is provided. 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

Request

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

timestampinteger
Example:1777680000000

Unix timestamp in milliseconds for the HIP-4 snapshot. If omitted, returns the latest snapshot. ISO 8601 strings are rejected.

depthinteger
Example:20

Maximum number of resting orders retained per side for this HIP-4 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
      }
    ],
    "asks": [
      {
        "oid": 18499128731,
        "user_address": "0x0000000000000000000000000000000000000000",
        "side": "B",
        "price": 105384.5,
        "size": 0.824,
        "timestamp": 1773273600123
      }
    ],
    "bid_count": 12,
    "ask_count": 15,
    "total_bid_size": 102.34,
    "total_ask_size": 98.76,
    "is_crossed": true
  }
}

Changes

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