Lighter
| Property | Value |
|---|---|
| Transport | WebSocket (order placement + market data) |
| Signing | Schnorr (ECgFp5 curve), key derived from your L1 wallet signature |
| Funding interval | 1 hour |
| Concurrent Spreadr maker trades | 1 per account (subject to change) |
| Builder code support | ✅ — 0.5 bp via integrator account index |
Premium tier required for maker legs. Standard-tier Lighter accounts are rejected when Lighter is the maker (quoting) side of a spread — Standard rate limits are too restrictive for quoting. Upgrade to Premium in Lighter's UI first. Using Lighter as the hedge leg works on either tier.
Account setup
Lighter uses an account-index model: your L1 wallet maps to a numeric account index, and orders are signed with a key registered against one of its API key slots. Spreadr discovers and generates all of this for you.
Open an account
Visit app.lighter.xyz (opens in a new tab), connect your L1 wallet (MetaMask etc.), and deposit USDC.
Connect in Spreadr
In the terminal: Settings → Wallets, pick your wallet, then + Lighter → Connect Lighter. Spreadr discovers your account index, generates the signing keypair in your browser, and registers it with Lighter — you sign 3 messages: key authorization, fee authorization, and the credential vault unlock. Nothing to copy or paste.
Quirks
- Use a dedicated trading sub-account. Lighter's signing key model doesn't have a trade-only restriction equivalent to HL/Extended/Orderly's agent/sub-key setups. We recommend a Lighter sub-account holding only the collateral you want exposed to bot trading, kept separate from your main holdings. See Security.
- One maker trade at a time. Lighter orders are signed against a strict per-key sequence counter, so Spreadr runs a single Lighter maker trade per account — the tightest concurrency cap of the six venues.
- Don't point another bot at the same account. A second process signing with the same key causes sequence collisions (rejected orders), and even with a separate key it eats the shared per-account rate budget.
- Volume quota. Lighter meters order actions with a consumable volume quota that refills as you trade. Spreadr throttles automatically when quota runs low; brand-new accounts with little trading history may see slower quoting until quota builds up.
Builder fees
Spreadr is registered as a Lighter integrator (account index in the builder
table). Takes 0.5 bp maker + 0.5 bp taker via the value/1e6 fee unit
(50 = 0.5 bp). Shows on Lighter's side as integrator fee.
Common errors
| Symptom | Cause | Fix |
|---|---|---|
| "Invalid nonce" | Another process is signing with the same API key | Make sure only Spreadr uses this key |
| "Not enough volume quota" | Order-action quota exhausted (new or low-volume account) | Spreadr throttles automatically; quota refills as you trade |
| "Account is Standard tier" | Lighter used as maker leg without Premium | Upgrade the account to Premium in Lighter's UI |
| "Insufficient collateral" | Margin too thin | Deposit USDC or reduce leverage |
| Trade fails to start | Stale or corrupted credentials | Delete the Lighter credential in Spreadr and reconnect |