Docs
How the station works.
Everything about plans, keys, payments and the data itself, in one place.
01
Getting started
02
Plans and $STOCKSAT
| Free | Holder | Pro | Pay per call | |
|---|---|---|---|---|
| Who gets it | Any wallet, free key | Hold $25 of $STOCKSAT (opens at launch) | Hold $250 of $STOCKSAT (opens at launch) | Any agent with USDG, no account |
| Calls a day | 1,000 | 10,000 | 100,000 | No limit |
| Rate limit | 30/min | 120/min | 600/min | 240/min per IP |
| Over quota | Pay per call | Pay per call, 20% off | Pay per call, 40% off | — |
| Support | Docs and community | Community, priority answers | Direct line to the team | Docs |
- — Your plan follows the USD value of $STOCKSAT in your signed-in wallet, read on Robinhood Chain and refreshed every 10 minutes. Nothing is staked or locked.
- — Quotas reset at 00:00 UTC. Past your quota, the API answers 402 and you can pay per call, with your plan's discount.
- — Pay-per-call needs no plan at all.
| Endpoint | Satellite | Price per call |
|---|---|---|
| GET /api/v1/quote/{symbol} | Pip | 0.001 USDG |
| GET /api/v1/book/{symbol} | Lumen | 0.002 USDG |
| GET /api/v1/derivs/{symbol} | Tide | 0.001 USDG |
| GET /api/v1/whales | Sentry | 0.003 USDG |
| GET /api/v1/candles/{symbol} | Pip | 0.002 USDG |
| GET /api/v1/markets · /reports · /status | — | Free |
03
API keys and sign-in
Sign in with your wallet
You sign one plain message. It is free, it is not a transaction and it never moves funds. Works with OKX Wallet, MetaMask, Rabby, Coinbase Wallet and smart-contract wallets.
stocksat.xyz wants you to sign in with your Ethereum account: 0xYourWallet Sign in to STOCKSAT to manage API keys. This is free: it is not a transaction and never moves funds. Chain ID: 4663 Nonce: a one-time code
Keys
- — Up to 5 active keys per wallet. Each starts with
ss_live_. - — The key is shown once. We store only its SHA-256 hash.
- — Send it as
Authorization: Bearer …orX-API-Key. - — Revoke a key any time from your account page. It stops working at once.
- — Sign-in sets one HttpOnly cookie for 30 days. We keep only its hash.
04
What the data means
| spot.price | Last trade on the TOKEN/USDG spot book on Lighter, Robinhood Chain. |
| perp.mark / perp.index | Lighter's mark price and index price for the perpetual. |
| open_interest / _usd | Open contracts in base units, and in USD at the mark price. |
| funding.lighter | Lighter's current published funding rate for the perp, unmodified. |
| funding.other_venues | Rates for the same market on Binance, Bybit and Hyperliquid, as published in Lighter's feed. |
| bids / asks | [price, size] levels, resting orders summed by price, best first. |
| depth_usd | USD value resting within 10, 50 and 100 bps of the mid, per side. |
| whales | Single fills of min_usd or more, watched every minute across spot and perp books. |
| as_of | When the upstream data was read (UTC). |
05
Limits and quotas
- — Per key: your plan's calls a minute and calls a day (table above).
- — MCP without a key: 100 calls a day and 20 a minute per IP.
- — Free endpoints (markets, reports, status): 20 calls a minute per IP.
- — Everyone: 240 requests a minute per IP as a flood brake.
- — The live demo on the home page: 20 downlinks an hour per visitor, never charged.
06
Status and uptime
The server checks every endpoint and every upstream source each minute and stores the result. The status page shows uptime and latency for the last 24 hours and 7 days from those checks.
07
FAQ
Which tokens are covered?+
Every stock and ETF token with a USDG spot book on Lighter's Robinhood Chain venue. The list updates itself when a new book opens. GET /api/v1/markets returns it.
How fresh is the data?+
Quotes are at most 10 seconds old, order books at most 2.5 seconds, funding at most 30 seconds. as_of tells you exactly.
Does STOCKSAT hold my funds?+
No. A payment is your own signed USDG transfer to the public treasury wallet. We only submit it on-chain, and only after your data is ready.
Can I use it from a browser?+
Yes. The API sends CORS headers, so a front end can call it with a key or a wallet signature.