> For the complete documentation index, see [llms.txt](https://docs.lighter.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lighter.xyz/developers/robinhood-chain/overview.md).

# Lighter on Robinhood Chain

Integrating Lighter on Robinhood Chain: endpoints, chain ID, deposits, tiers and everything else that differs from Lighter mainnet.

Lighter also runs as a separate exchange on **Robinhood Chain** ("Lighter RH"). It uses the same transaction format, signer, REST API and WebSocket channels as Lighter mainnet, so everything in these docs applies. This page lists **only what's different**.

{% hint style="warning" %}
**A separate exchange**

Lighter RH is a **separate exchange**, not another market on Lighter mainnet. Accounts, balances, API keys, nonces and account indexes don't carry over, and mainnet signatures use distinct chain IDs. RH testnet shares chain ID `300` with Lighter testnet. Keep the base URL and chain ID together; do not rely on the chain ID to distinguish the testnets.
{% endhint %}

Use the shared [API Reference](https://docs.lighter.xyz/api) and select `https://api.rh.lighter.xyz` (mainnet) or `https://api.rh-testnet.lighter.xyz` (testnet) in the server selector.

## Endpoints & chain ID

| Item                   | RH mainnet                                                      | RH testnet                                        |
| ---------------------- | --------------------------------------------------------------- | ------------------------------------------------- |
| REST base URL          | `https://api.rh.lighter.xyz`                                    | `https://api.rh-testnet.lighter.xyz`              |
| REST API prefix        | `/api/v1/`                                                      | `/api/v1/`                                        |
| WebSocket              | `wss://api.rh.lighter.xyz/stream`                               | `wss://api.rh-testnet.lighter.xyz/stream`         |
| Chain ID (for signing) | **`466324`**                                                    | `300`                                             |
| Explorer API           | `https://explorerapi.rh.lighter.xyz/api/`                       | `https://explorerapi.rh-testnet.lighter.xyz/api/` |
| Lighter contract       | `0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9d` on Robinhood Chain |                                                   |

To point the [TypeScript quickstart](/developers/getting-started/quickstart-typescript.md) at RH, change only the config:

```shell
export LIGHTER_URL=https://api.rh.lighter.xyz
export LIGHTER_CHAIN_ID=466324
```

The read-only WebSocket for restricted regions works the same: `wss://api.rh.lighter.xyz/stream?readonly=true`.

## Deposits & withdrawals

|                      | Lighter mainnet                                                                      | Lighter RH                                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Deposit chain        | Ethereum (+ other chains via bridge)                                                 | **Robinhood Chain**                                                                                                                                                   |
| Main collateral      | USDC                                                                                 | **USDG** (6 decimals)                                                                                                                                                 |
| Other deposit assets | See [Deposits](/developers/integration-guides/deposits-transfers-and-withdrawals.md) | ETH (spot only) and the tokenized stocks/ETFs listed in `assetDetails` (SPY, QQQ, NVDA, AAPL, ...)                                                                    |
| Deposit methods      | Contract `deposit`, bridge                                                           | Contract `deposit(_to, _assetIndex, _routeType, _amount)`, or an **intent address**: a persistent address that credits USDG on plain transfers, with no contract call |
| Minimum              | See [Deposits](/developers/integration-guides/deposits-transfers-and-withdrawals.md) | 1 USDG (or equivalent) per deposit                                                                                                                                    |
| Fast withdrawals     | USDC                                                                                 | **USDG only**, minimum 1 USDG                                                                                                                                         |

Secure withdrawals go through the contract's `withdraw` method, as on mainnet. Transfers to other addresses and fast withdrawals need the owner's L1 signature, as on mainnet (see [When an L1 signature is required](/developers/reference/wasm-signer.md#when-an-l1-signature-is-required)).

## API keys

Indexes **0–3 and 157** are reserved for Lighter's web and mobile apps. Use **4–156 or 158–254** for your integration. Auth tokens, read-only tokens and maker-only keys work as on mainnet.

## Account tiers

Premium tiers are based on your **14-day trading volume**, not on staked LIT.

|                      | Standard (default) | Plus                 | Premium                                                        |
| -------------------- | ------------------ | -------------------- | -------------------------------------------------------------- |
| Maker / taker fee    | 0% / 0%            | 0.015% / 0.015%      | 0.0120% / 0.0350%, down to 0.0084% / 0.0245% at > $500M volume |
| Taker latency        | 300 ms             | 300 ms               | 200 ms, down to 150 ms at > $500M volume                       |
| Maker latency        | **200 ms**         | 200 ms               | 0 ms                                                           |
| Cancel latency       | 200 ms             | 200 ms               | 0 ms                                                           |
| sendTx / sendTxBatch | within 60 req/min  | 8,000/min            | 4,000–24,000/min by volume                                     |
| REST (non-sendTx)    | 60 req/min         | 120,000 weighted/min | 24,000 weighted/min                                            |
| Sub-accounts         | 8                  | 8                    | 8                                                              |

Differences from mainnet to watch for:

* **Standard maker orders are not free of delay.** On mainnet, post-only orders on Standard execute with a 0 ms delay; on RH they wait 200 ms.
* **Standard, Plus and Premium accounts are capped at 8 sub-accounts** (mainnet: 4 Standard, 16 Plus, 64 Premium).

Premium volume tiers:

| 14-day volume | Maker fee | Taker fee | Taker latency | sendTx / min |
| ------------- | --------- | --------- | ------------- | ------------ |
| Under $1M     | 0.0120%   | 0.0350%   | 200 ms        | 4,000        |
| > $1M         | 0.0117%   | 0.0341%   | 195 ms        | 5,000        |
| > $10M        | 0.0114%   | 0.0333%   | 190 ms        | 6,000        |
| > $20M        | 0.0108%   | 0.0315%   | 180 ms        | 7,000        |
| > $50M        | 0.0102%   | 0.0298%   | 170 ms        | 8,000        |
| > $200M       | 0.0096%   | 0.0280%   | 160 ms        | 12,000       |
| > $500M       | 0.0084%   | 0.0245%   | 150 ms        | 24,000       |

Switching tiers works as on mainnet ([changeAccountTier](https://docs.lighter.xyz/api/account)): downgrades require a 24-hour cooldown after the last tier change and a sub-account count that fits the lower tier. Upgrades can happen at any time.

Builder accounts are available by application through Discord: 25,000 sendTx/sendTxBatch per minute, 150,000 weighted read-only requests per minute, and up to 1,000 sub-accounts. See [Builder accounts](/developers/reference/account-types.md#builder-accounts).

## Rate limits

REST weights on RH:

| Endpoint                                                                                                                                                                                                | Weight |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| `sendTx`, `sendTxBatch`, `nextNonce`                                                                                                                                                                    | 6      |
| `publicPools`, `txFromL1TxHash`                                                                                                                                                                         | 50     |
| `accountInactiveOrders`, `accountActiveOrders`, `accountOrders`, `deposit/latest`                                                                                                                       | 100    |
| `exchangeMetrics`, `executeStats`                                                                                                                                                                       | 120    |
| `apikeys`, `account`                                                                                                                                                                                    | 150    |
| `transferFeeInfo`                                                                                                                                                                                       | 500    |
| `trades`, `recentTrades`                                                                                                                                                                                | 600    |
| `changeAccountTier`, `tokens/revoke`, `setAccountMetadata`, `notification/ack`, `createIntentAddress`, `fastwithdraw`, `referral/create`, `referral/use`, `referral/update`, `referral/kickback/update` | 3,000  |
| `tokens/create`                                                                                                                                                                                         | 23,000 |
| `/stream`                                                                                                                                                                                               | 90     |
| Others, including referral reads                                                                                                                                                                        | 300    |

Note that `trades` costs 600 on RH (200 on mainnet).

RH allows 20 fast withdrawals per hour. Other transaction-type limits are listed in [Rate Limits](/developers/reference/rate-limits.md). RH Explorer allows 15 weighted requests per minute, with a burst of 15.

Pending orders are limited to 200 per account / 16 per market for Standard and Plus, and 2,000 / 160 for Premium. Active orders are limited to 1,000 per account and per market for these tiers.

The [volume quota](/developers/reference/volume-quota.md) works the same way: earned per market from trading volume (1 quota per $1 on most RH markets, $2 on the rest), starting at 1,000, capped at 15,000,000 from trading and 30,000,000 with [purchased quota](/developers/reference/volume-quota.md#buying-volume-quota), shared across the L1 address. `buyVolumeQuota` pays the RH payment account (index `51687`), not the Lighter one.

## Checklist for supporting both

* Keep **base URL and chain ID together** in one config object; never mix them.
* Store account indexes, API keys and nonces **per exchange**.
* Read market IDs and decimals from each exchange's `orderBookDetails`; don't reuse mainnet market IDs.
* Label balances by collateral (USDC vs USDG).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lighter.xyz/developers/robinhood-chain/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
