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.
A separate exchangeLighter RH is a separate exchange, not another market on Lighter mainnet. Accounts, balances, API keys, nonces and account indexes don't carry over, and a transaction signed for one is rejected by the other.
The full API reference for RH is at apidocs.rh.lighter.xyz.
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 | See RH docs |
| Chain ID (for signing) | 466324 | 300 |
| Lighter contract | 0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9d on Robinhood Chain |
To point the TypeScript quickstart at RH, change only the config:
export LIGHTER_URL=https://api.rh.lighter.xyz
export LIGHTER_CHAIN_ID=466324The 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 | ETH, USDC and other ERC-20s on Robinhood Chain |
| 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 | 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).
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.005% / 0.005% | 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.
- Sub-accounts are capped at 8 on every tier (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, 24-hour cooldown on downgrades).
Rate limits
REST weights on RH:
| Endpoint | Weight |
|---|---|
sendTx, sendTxBatch, nextNonce | 6 |
publicPools, txFromL1TxHash | 50 |
accountInactiveOrders, deposit/latest | 100 |
apikeys | 150 |
transferFeeInfo | 500 |
trades, recentTrades | 600 |
changeAccountTier, tokens, tokens/revoke, setAccountMetadata, notification/ack, createIntentAddress, fastwithdraw, referral/* | 3,000 |
tokens/create | 23,000 |
| Others | 300 |
Note that trades costs 600 on RH (200 on mainnet).
Per-transaction-type limits are the same as on mainnet. The volume quota works the same way: one extra transaction per $2 of volume, starting at 1,000 and capped at 15,000,000, shared across the L1 address.
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).
Updated 1 day ago