Hyperliquid Generated Order-Book Snapshots
Retrieve or stream generated Hyperliquid order-level snapshots through the V3 raw gRPC service.
Hyperliquid RPC endpoint: endpoint URLs, plans and pricing.
orderbook_snapshots is generated data containing individual open orders across available markets at a point in time. It is separate from node-written feeds. Snapshot RPCs are intentionally absent from ListFeeds and use their own documented positioning rules.
Access
| Availability | Access | Details |
|---|---|---|
| Live / replay | StreamOrderbookSnapshots and GetOrderbookSnapshot | Stream generated snapshots from a timestamp or from the latest available record; retrieve one generated snapshot. |
| Live | Order Book WebSocket L4 | Live snapshot-plus-update alternative for a continuously maintained single-market book. |
| Archival | S3 Bucket | S3 coverage for orderbook_snapshots: 2026-04-14 to today, stored as <height>.json.lz4. |
Snapshot behavior
StreamOrderbookSnapshots accepts an inclusive Unix-millisecond timestamp cursor. With no position, it sends the latest available snapshot immediately and then newer snapshots. A positioned stream begins with the snapshot covering the requested timestamp. GetOrderbookSnapshot also returns the snapshot covering the requested timestamp; an empty request returns the latest available snapshot.
Snapshot availability and maximum response size vary by endpoint. A timestamp outside retained history returns NOT_FOUND, while an oversized response returns RESOURCE_EXHAUSTED. In V3, block_number and timestamp are transport cursors outside decoded Record.data. The bytes in Record.data decode directly to the snapshot's top-level array.
Sample data
This synthetic decoded V3 Record.data payload visibly redacts the market and client-order identifiers. The numeric order ID is synthetic:
[
[
"<redacted-market>",
[
[
{
"coin": "<redacted-market>",
"side": "B",
"limitPx": "114250.0",
"sz": "0.40",
"oid": 123456789,
"timestamp": 1785736809123,
"triggerCondition": "N/A",
"isTrigger": false,
"triggerPx": "0.0",
"children": [],
"isPositionTpsl": false,
"reduceOnly": false,
"orderType": "Limit",
"origSz": "0.40",
"tif": "Gtc",
"cloid": "<redacted-client-order-id>"
}
],
[]
]
]
]Each top-level entry is [coin, [bids, asks]]. Individual order metadata can vary by order type.
Observed fields
[] marks an array element, [0] a tuple position, <name> an object whose type is that name, and {key} a map keyed by user, asset, or ID. Values after a colon are every distinct value seen for a short enum field. A field missing here can still appear in record types the sample did not contain.
Generated from 1 records in orderbook_snapshots/20261021/1191310000.json.lz4 (2026-10-21).
[] array
[][0] string
[][1] array
[][1][] array
[][1][][] object
children array
cloid null | string
coin string
isPositionTpsl bool
isTrigger bool
limitPx string
oid number
orderType string: Limit
origSz string
reduceOnly bool
side string: A, B
sz string
tif string: Alo, Gtc
timestamp number
triggerCondition string: N/A
triggerPx string
[][] array | string
[][][] array
[][][][] object
children array
children[] object
children array
cloid null | string
coin string
isPositionTpsl bool
isTrigger bool
limitPx string
oid number
orderType string: Stop Limit, Stop Market, Take Profit Limit, Take Profit Market
origSz string
reduceOnly bool
side string: A, B
sz string
tif null
timestamp number
triggerCondition string
triggerPx string
cloid null | string
coin string
isPositionTpsl bool
isTrigger bool
limitPx string
oid number
orderType string: Limit, Stop Limit, Stop Market, Take Profit Limit
origSz string
reduceOnly bool
side string: A, B
sz string
tif null | string: Alo, Gtc
timestamp number
triggerCondition string: N/A, Triggered
triggerPx stringRelated pages
- Order book WebSocket guide — Implement snapshot handling, updates, and reconnection.
- L4 books — Maintain the order-level live state represented by a snapshot.