Hyperliquid BBO - Best Bid and Offer
Consume typed Hyperliquid best-bid-and-offer updates through V3 gRPC or the Order Book WebSocket.
Hyperliquid RPC endpoint: endpoint URLs, plans and pricing.
BBO is the lowest-bandwidth order-book view. It reports the best bid and best ask for each requested market, including price, resting size, and order count at each top level.
Access
| Availability | Access | Details |
|---|---|---|
| Live | StreamBbo | Provides typed V3 updates for up to 20 coins. |
| Live | Order Book WebSocket BBO | Provides the live JSON bbo channel. |
| Archival | S3 Bucket | Historical top-of-book reconstruction requires a known snapshot or state seed followed by ordered book diffs; raw records alone are insufficient. |
Live behavior
StreamBbo requires 1-20 coins after duplicate removal. It sends a typed initial current value for each requested coin, then sends another update only when that coin's top of book changes. bid or ask is unset when that side is empty, and ordering between different coins is unspecified.
BBO is a live view with no historical replay. Snapshot-style recovery can send the current value again after subscriber lag. If the RPC closes with ABORTED, reconnect to receive fresh current values.
Sample data
This synthetic V3 protobuf payload visibly redacts the market identifier:
coin: "<redacted-market>"
time: 1785736814057
block_number: 1058646974
bid: { px: "114250.0" sz: "1.35" n: 4 }
ask: { px: "114251.0" sz: "0.82" n: 3 }Treat each side as optional. An empty side is represented by an unset message field, not a zero-valued price level.
Related pages
- Order book WebSocket guide — Build a resilient top-of-book and spread client.
- L2 books — Move from top-of-book prices to aggregated market depth.