CAsoon

Docs

How the station works.

Everything about plans, keys, payments and the data itself, in one place.

01

Getting started

02

Plans and $STOCKSAT

FreeHolderProPay per call
Who gets itAny wallet, free keyHold $25 of $STOCKSAT (opens at launch)Hold $250 of $STOCKSAT (opens at launch)Any agent with USDG, no account
Calls a day1,00010,000100,000No limit
Rate limit30/min120/min600/min240/min per IP
Over quotaPay per callPay per call, 20% offPay per call, 40% off—
SupportDocs and communityCommunity, priority answersDirect line to the teamDocs
  • — 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.
EndpointSatellitePrice per call
GET /api/v1/quote/{symbol}Pip0.001 USDG
GET /api/v1/book/{symbol}Lumen0.002 USDG
GET /api/v1/derivs/{symbol}Tide0.001 USDG
GET /api/v1/whalesSentry0.003 USDG
GET /api/v1/candles/{symbol}Pip0.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 … or X-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.priceLast trade on the TOKEN/USDG spot book on Lighter, Robinhood Chain.
perp.mark / perp.indexLighter's mark price and index price for the perpetual.
open_interest / _usdOpen contracts in base units, and in USD at the mark price.
funding.lighterLighter's current published funding rate for the perp, unmodified.
funding.other_venuesRates 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_usdUSD value resting within 10, 50 and 100 bps of the mid, per side.
whalesSingle fills of min_usd or more, watched every minute across spot and perp books.
as_ofWhen 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.
Docs and plans · STOCKSAT