/v1/rh-lighter/*: L2 order books, trades, candles, funding, open interest, liquidations, freshness, summaries, price history, and account positions for its USDG-quoted perpetual and spot markets. The routes mirror Lighter mainnet’s /v1/lighter/* except L3, which this deployment does not capture. Find a market with GET /v1/rh-lighter/instruments, and see the exact contracts in Lighter on Robinhood Chain endpoints. For Lighter mainnet, use Lighter REST.
How it differs from Lighter mainnet
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; list them with/v1/rh-lighter/instruments.
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.
This deployment has no L3 capture. The l3orderbook paths under this namespace answer 404 with error_code unsupported_for_venue, and the response’s available_on list points to Lighter mainnet’s /v1/lighter/l3orderbook/{symbol}. Use /v1/rh-lighter/orderbook/{symbol} for this deployment’s depth.
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
Perpetual symbols are uppercase base assets such asBTC 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.
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 have the same two tiers as Lighter mainnet; Trades documents the shared contract./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.