> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lighter on Robinhood Chain REST API

> Run Lighter on Robinhood Chain REST routes under /v1/rh-lighter for L2 order books, trades, candles, funding, OI, liquidations, and freshness.

Pull data for Lighter on Robinhood Chain, Lighter's second deployment, under `/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](/api-reference/rh-lighter). For Lighter mainnet, use [Lighter REST](/rest-api/lighter).

## 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`.

| Question | Lighter on Robinhood Chain, compared with mainnet |
| - | - |
| REST namespace | `/v1/rh-lighter/*`; mainnet is `/v1/lighter/*` |
| Quote asset | USDG; mainnet is USDC |
| Perp symbols | `BTC`, `ETH`, the same text as mainnet |
| Spot symbols | Dashed pair with the quote, such as `AAPL-USDG`; mainnet spot is not covered |
| L3 order-level book | Not captured; mainnet serves `/v1/lighter/l3orderbook/{symbol}` |
| WebSocket channels | `rh_lighter_*`; mainnet uses `lighter_*` |
| Export exchange key | `rh-lighter`; mainnet is `lighter` |

A `BTC` request to each namespace reads a different market. Store the namespace with every record, file, and log line.

## Routes

Every route is `GET` and takes the same parameters as its mainnet Lighter counterpart.

| Route | Returns |
| - | - |
| `/v1/rh-lighter/instruments` | Every market with its symbol, market type, and precision |
| `/v1/rh-lighter/instruments/{symbol}` | One market |
| `/v1/rh-lighter/orderbook/{symbol}` | Current aggregated L2 book |
| `/v1/rh-lighter/orderbook/{symbol}/history` | L2 book history |
| `/v1/rh-lighter/trades/{symbol}` | Finalized trade history, clamped to `meta.finalized_through` |
| `/v1/rh-lighter/trades/{symbol}/recent` | Recent trades, including preliminary rows counted by `meta.preliminary_row_count` |
| `/v1/rh-lighter/candles/{symbol}` | OHLCV candles |
| `/v1/rh-lighter/openinterest/{symbol}` | Open interest history (perps) |
| `/v1/rh-lighter/openinterest/{symbol}/current` | Current open interest (perps) |
| `/v1/rh-lighter/funding/{symbol}` | Funding rate history (perps) |
| `/v1/rh-lighter/funding/{symbol}/current` | Current funding rate (perps) |
| `/v1/rh-lighter/liquidations/{symbol}` | Liquidation events |
| `/v1/rh-lighter/liquidations/{symbol}/volume` | Liquidation volume buckets |
| `/v1/rh-lighter/freshness/{symbol}` | Latest stored timestamp per data type |
| `/v1/rh-lighter/summary/{symbol}` | Market summary |
| `/v1/rh-lighter/prices/{symbol}` | Price history |

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](/rest-api/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

```bash theme={"theme":"github-dark"}
curl "https://api.0xarchive.io/v1/rh-lighter/orderbook/BTC?depth=5" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"
```

The response uses the mainnet Lighter L2 shape: `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:

```bash theme={"theme":"github-dark"}
curl "https://api.0xarchive.io/v1/rh-lighter/trades/AAPL-USDG/recent?limit=10" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"
```

## Symbols and markets

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.

| Data | History from (UTC) |
| - | - |
| Trades | 2026-06-26 20:10:26, the deployment's first trade; finalized from Lighter's daily trade export |
| Liquidations | 2026-06-26 20:10:26; rows before live capture (2026-08-22) were backfilled from the venue's finalized export |
| Candles | 2026-06-26 20:10, built from trades from the deployment's first trade |
| Account positions | 2026-06-26, change log and hourly snapshots; see [Account positions](/rest-api/positions) |
| L2 order book | 2026-08-22 18:43, current book and history |
| Open interest | 2026-08-22 18:43, perps only |
| Funding | 2026-08-22 18:43, perps only |
| L3 order-level book | Not captured; use L2 |

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](/rest-api/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 to `rh_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](/websocket/lighter#lighter-on-robinhood-chain).

## Exports

The Data Catalog exports this deployment under the exchange key `rh-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](/export-schemas).

## Next step

Make a first request and confirm the response with the [Lighter on Robinhood Chain quickstart](/lighter-robinhood-chain-api-quickstart).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.