Connect Lighter on Robinhood Chain
Lighter’s deployment on Robinhood Chain connects through a wallet and trades tokenized-stock spot and perpetuals. This guide covers what to prepare and how to add the account in Trade.
Prepare on the exchange
This deployment and Lighter mainnet are separate: accounts and API keys don’t carry over, so you add each one on its own. For mainnet, see Connect Lighter.
The wallet must have made a deposit on Lighter on Robinhood Chain.
Turn on Unified Trading Account in its settings. Simple Trading Accounts are not supported.
Check the account tier. A wallet on the free Standard tier must be upgraded to Plus before it can be added. The window takes you through this when you add the account.
Adding with Connect wallet needs nothing else. To add with Enter API key, first generate an API key on the API Keys page at robinhoodchain.lighter.xyz, and note its private key and the API Key Index you used. Don’t turn on Maker-only when you generate it: with it on, the key can only place maker orders, and a combo’s taker leg is rejected.
There is no API key IP allowlist here, so the Add account window doesn’t list egress IPs.
Account mode and position mode
The only account mode is Unified Trading Account: USDG collateral, tokenized-stock spot and perpetuals, cross margin only. Trade doesn’t switch the account mode for you.
Perpetuals use one-way mode, with nothing to set up. Contract leverage is set in the combo, and Trade applies it on the exchange.
Enter it in Trade
In Trade, open Accounts, choose Add account, select Lighter on Robinhood Chain, then pick a Connection method. For the general steps, see Connect an exchange.
Connect wallet
Choose Connect wallet to connect your wallet, then choose Authorize and add.
Confirm each signature in your wallet as the window prompts. The window says what each step signs, how many signatures remain and any fee a step involves.
If the wallet is on the free tier, the window first asks you to upgrade to Plus. To accept, choose Upgrade to Plus and continue. This step needs no signature.
Manual API
| Field | What to enter |
|---|---|
| L1 wallet address | The address of the wallet you connect to robinhoodchain.lighter.xyz with |
| API private key | The private key you got when generating the API key. Don’t enter the public key |
| API key index | The API Key Index used for this key, from 4 to 254 and not 157 |
If the window says a signature is still needed, sign with this wallet as prompted.
Both methods also need an Account name and at least one of spot or perpetuals under Supported markets.
Common questions
“This wallet doesn’t have an exchange account yet”
Deposit to this wallet on Lighter on Robinhood Chain first, then connect again.
The API Key Index is rejected
Enter the number you used when generating this key. 0 to 3 and 157 are reserved for the web and mobile apps.
A Lighter mainnet API key can’t be added
API keys don’t carry over between the two. Generate another one at robinhoodchain.lighter.xyz.