Pull Lighter mainnet market data under /v1/lighter/*: L2 order books, L3 individual-order books, trades, candles, funding, open interest, liquidations, and account positions. Lighter is its own venue with its own symbols, separate from Hyperliquid, and its individual-order depth is L3, not Hyperliquid L4. Find a market with Lighter instruments, and check each data type’s history start in Venue coverage. For an overview of the venue, see Lighter market data.
Lighter has two deployments: mainnet and Robinhood Chain. This page covers mainnet. The Robinhood Chain deployment is served under /v1/rh-lighter/* with the same routes except L3; see Lighter on Robinhood Chain REST.
Route groups
First request
Lighter L2 has the same shape as the Hyperliquid order book: px, sz, and n as decimal strings; see the field dictionary.
Choose a depth
Use the L2 order-book routes for price-level depth. Use /v1/lighter/l3orderbook/{symbol} when you need individual resting orders, for queue analysis or reconstruction. The current L3 route returns one book object; the history route returns an array of snapshots. History granularity defaults to checkpoint and also accepts 30s, 10s, 1s, and tick, and each item holds up to 250 orders per side. L3 fields are numeric order_index, owner_account_index, price, remaining_size, and original_size, not L2 px and sz strings, and the two index fields are Lighter indexes, not wallet addresses. Order books compares L2 and L3 in more detail.
For long windows, start with one bounded request, page with the cursor, and store meta.request_id for each page. Check the window with Data quality before it feeds a backtest, model, alert, dashboard, or export, especially when reconstruction depends on depth continuity.
Trades: canonical and preliminary
Lighter trade routes have two tiers. /v1/lighter/trades/{symbol} serves canonical per-fill history reconciled daily from the Lighter Foundation archive: rows marked source: "bucket", enriched with fields such as tx_hash, order_id, fee, realized_pnl, and maker/taker attribution, with end clamped to the finalization watermark in meta.finalized_through. Per-fill rows begin January 17, 2025, with exact starts varying by market. /v1/lighter/trades/{symbol}/recent serves preliminary live rows marked source: "ws" without that enrichment. Identity fields such as account_index are Lighter account indexes, not wallet addresses.
Field sets and the clamp are documented on Trades and in Lighter Historical Data API. The generated contracts are Lighter trades and current Lighter funding.
Live data over WebSocket
For continuing updates, subscribe to lighter_orderbook, lighter_trades, lighter_open_interest, or lighter_funding on wss://api.0xarchive.io/ws instead of polling these routes. Live messages use different payload shapes from the REST responses, and live trades are preliminary until the canonical trade route finalizes them. Current candles and L3 snapshots stay on REST. See Lighter WebSocket channels, and WebSocket replay when event order matters.
Next step
Make a first Lighter request and confirm the response with the Lighter quickstart. Last modified on October 6, 2026
