Skip to main content
Pull Hyperliquid Spot pairs, order books, trades, candles, L4 depth, order history, and TWAP under /v1/hyperliquid/spot/*. Spot routes take pair symbols such as HYPE-USDC; perp symbols such as BTC belong to the core namespace.

Routes

The L4 routes serve L4 resting-book checkpoints and ordered diffs. Order history returns separate historical order-lifecycle records, not L4 book state. Exact parameters are in the Spot endpoint reference.

Example

Reconstruct an L4 book

Start from a checkpoint route, then apply diffs in order. When no checkpoint exists for the requested timestamp, keep the error’s request_id in your logs.

Freshness and empty results

A pair can have no checkpoint at a given timestamp, or no records in a window, while the route itself is available. Treat that as a normal result and never fill in a book. Check /v1/hyperliquid/spot/freshness/{symbol} before reconstruction, alerting, exports, or model inputs depend on Spot data.

Next step

Last modified on October 18, 2026