π Data API
The Data API is the read layer behind the Storm app. Use it for market discovery, prices, position and order history, vaults, referrals and leaderboards. All endpoints listed here are public GET requests.
- Mainnet:
https://api.storm.tg/api
- Stage:
https://api.stage.stormtrade.dev/api
- Full schemas: Swagger
To place orders use the Trading API (V3).
π Markets and Prices
| Path | Returns |
|---|
/markets | All markets with current state: index price, reserves, open interest per side, funding |
/markets/{address} | One market |
/markets/stats | Aggregated market statistics |
/recent-trades, /recent-trades/{asset} | Latest executed trades |
/trade-status/market/{market} | Whether trading is currently open on the market |
/config/assets, /config/assets-config | Asset list and per-asset parameters |
/config/assets-schedule | Trading schedule for RWA markets |
/config/dex-prices | USD prices for assets without a signed oracle feed, 10^9 scaled |
/config/settlement-rates | Factor converting settlement-token notional to USD, 10^9 scaled |
/config, /config/time, /config/ui-bootstrap | Global protocol and contract configuration |
Market identifiers are vAMM contract addresses. Cache /markets and refresh it periodically rather than per request.
π§Ύ Positions and Orders
trader is the user's wallet address for v2 or Smart Account address for v3.
| Path | Returns |
|---|
/positions/{trader}/active | Open positions |
/positions/{trader}/{asset}/active | Open positions in one market |
/positions/{trader}/{asset}/history | Closed positions in one market |
/positions/{trader}/portfolio/history | Portfolio value over time |
/positions/{id} | One position by id |
/positions/{id}/history | Events of one position |
/positions/{id}/close-stats | Realized result of a closed position |
/orders/{trader}/active | Open orders |
/orders/{trader}/{asset}/active | Open orders in one market |
/orders/{trader}/{asset}/history | Order history in one market |
π§ Vaults and Liquidity
| Path | Returns |
|---|
/vaults | All vaults with current data |
/vaults/{vault} | One vault |
/vaults/{vault}/rates/{timeframe} | Vault ROI and rate history over a timeframe |
/liquidity-providers/{vault}/{trader} | A provider's current state in a vault |
π Trader Stats
| Path | Returns |
|---|
/trader-stats/leaderboard | Leaderboard |
/trader-stats/{trader}/stats | Aggregate stats of one trader |
/trader-stats/{trader}/pnl-history | PnL over time |
/trader-stats/{trader}/first-trade-date | First trade timestamp |
/stats/cumulative | Protocol-wide cumulative stats |
π Referrals
| Path | Returns |
|---|
/referral/trader/{address} | Referrer bound to a trader |
/referral/referrer/{owner} | Referrer NFT info by owner |
/referral/referrer/{owner}/earnings | Referral earnings, split by v2 and v3 |
/referral/referrer/{owner}/traders | Trading stats of referred traders |
/referral/nft/{address}, /referral/nft/by-id/{refId} | Referral NFT details |
See Referral Program for how referral NFTs work.
π STORM Token and Supply
| Path | Returns |
|---|
/storm-token/summary | Token summary |
/storm-token/staking, /lp, /vesting, /vouchers, /leaderboard | Staking, LP, vesting and voucher data |
/supply/total, /supply/circulating | Supply figures |
/coingecko/contracts | CoinGecko derivatives feed |
