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.
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
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
Start of the requested window as a Unix timestamp in milliseconds. ISO 8601 strings are rejected.
End of the requested window as a Unix timestamp in milliseconds. ISO 8601 strings are rejected.
Timestamp cursor in Unix milliseconds from the previous response metadata.
Maximum number of results (default: 100, max: 1000)
Response
Typed L4 orderbook checkpoint array
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.