/v1/rh-lighter/*. Use it for USDG-quoted perpetual and spot markets on Robinhood Chain: L2 depth, trades, candles, funding, open interest, liquidations, freshness, summaries, price history, and account positions. For Lighter mainnet, use Lighter REST.
Answer: Use
/v1/rh-lighter/* for Lighter on Robinhood Chain. The routes mirror /v1/lighter/* except L3, which this deployment does not capture. Keep Robinhood Chain symbols, account indexes, and history apart from mainnet even when the symbol text matches.Evidence: Start with GET /v1/rh-lighter/instruments, open the Lighter on Robinhood Chain endpoints, confirm the operation in OpenAPI, and check Venue coverage.One venue, two deployments
Lighter on Robinhood Chain runs the same exchange engine as Lighter mainnet, on a separate chain with separate markets, separate account indexes, and its own history. It is a deployment of Lighter, not a third venue. Its markets are quoted in USDG. At launch it lists 84 markets: 57 perpetuals and 27 spot markets.
A
BTC request to each namespace reads a different market. Store the namespace with every record, file, and log line.
Routes
Every route isGET and takes the same parameters as its mainnet Lighter counterpart.
Account positions for this deployment live under the same namespace:
/v1/rh-lighter/accounts/{account_index}/positions, its /history and /changes, and the market routes /v1/rh-lighter/positions/{symbol}, /summary, and the bulk /v1/rh-lighter/positions. See Account positions.
The l3orderbook paths under this namespace answer 404 with a message that points to /v1/rh-lighter/orderbook/{symbol}, because this deployment has no L3 capture.
First request
bids and asks arrays of px, sz, and n decimal strings, plus mid_price, spread, and spread_bps, with prices in USDG. Keep meta.request_id with the result.
Spot markets use the dashed pair symbol in the path:
Symbols and markets
Discover symbols withGET /v1/rh-lighter/instruments. Perpetual symbols are uppercase base assets such as BTC and ETH. Spot symbols are the base and the USDG quote joined by a dash, such as AAPL-USDG. Market-data routes accept symbols in any case and return them uppercase. Account positions routes take the symbol exactly as /v1/rh-lighter/instruments lists it, such as BTC.
Spot markets have order books, trades, and candles. Funding, open interest, and liquidations exist only for perpetual markets. Account positions cover perpetual markets.
Coverage
History on this deployment starts when capture of each data type began, not when the deployment opened. Earlier order-book, open-interest, and funding history cannot be recovered, because the deployment publishes no archive of those streams.
Until candles are enabled for this deployment,
/v1/rh-lighter/candles/{symbol} returns 400 with the message Candles are not yet available for Lighter (Robinhood Chain). Trades, orderbook, open interest, funding and liquidations are. Check /v1/symbols or the route itself before scheduling a candle job. Confirm symbol-level windows with /v1/data-quality/coverage/rh-lighter/{symbol} before a long history pull.
Trades: finalized and preliminary
Trade routes on this deployment are two-tier, exactly like mainnet Lighter./v1/rh-lighter/trades/{symbol} serves the finalized per-fill record, reconciled daily from Lighter’s historical trade export for this deployment and marked source: "bucket".
Finalized rows carry the same enriched fields as mainnet canonical trades: order_id, tx_hash, fee, realized_pnl, usdc_amount, maker and taker attribution, and position state before and after the fill. Amounts named after USDC, and fees, are in USDG on this deployment.
The finalization watermark trails the present by about a day. meta.finalized_through reports it on every response. When your end is past the watermark, the response adds meta.requested_end and meta.clamped_to and returns finalized rows only. Rows newer than the watermark are served by /v1/rh-lighter/trades/{symbol}/recent, marked source: "ws" and counted by meta.preliminary_row_count. Treat those rows as provisional until the next reconcile.
Identity fields such as account_index hold Robinhood Chain account indexes as strings. They are not wallet addresses, and they are unrelated to mainnet account indexes with the same number.
Liquidations
/v1/rh-lighter/liquidations/{symbol} returns the same row shape as mainnet Lighter liquidations, with USDG amounts. Use /v1/rh-lighter/liquidations/{symbol}/volume for bucketed totals.
Liquidation history on this deployment starts at the first trade, 2026-06-26 20:10:26 UTC. Rows from before live capture began on 2026-08-22 18:43 UTC carry source: "bucket" and an empty raw_json, and live-captured rows carry source: "ws" and the venue’s original message in raw_json. The earlier rows were backfilled from the venue’s finalized export, which has no raw message to preserve.
Live data over WebSocket
Subscribe torh_lighter_orderbook, rh_lighter_trades, rh_lighter_open_interest, or rh_lighter_funding on wss://api.0xarchive.io/ws for continuing updates. Live messages use the mainnet Lighter live shapes, and live trades are preliminary until this route finalizes them. rh_lighter_candles is replay-only. See Lighter on Robinhood Chain channels.
Exports
The Data Catalog exports this deployment under the exchange keyrh-lighter with the l2_orderbook, trades, funding, and oi schemas. An l2_orderbook export includes a second file of periodic full-book snapshots to seed reconstruction, as on mainnet. See Export schemas.