{"format":"opendoc-document","version":1,"url":"https://docs.storm.tg/developers/api_v2","title":"📚 Read markets and history","description":"Read markets, prices, positions and trading history through the API reference. These reads need no API key and use https://api.storm.tg/api .","kind":"article","locale":"en","inLanguage":"en","lastModified":"2026-10-09T14:26:32+03:00","revision":"d36475e7b456c737fae6933fa27b7e1bc2687f2c19291b05725ab2c4e8f79d7a","section":{"title":"For Developers","url":"https://docs.storm.tg/developers"},"representations":{"html":"https://docs.storm.tg/developers/api_v2","markdown":"https://docs.storm.tg/developers/api_v2.md","json":"https://docs.storm.tg/developers/api_v2.json"},"translations":{"en":"https://docs.storm.tg/developers/api_v2"},"breadcrumbs":[{"title":"⚡ About Storm Trade","url":"https://docs.storm.tg"},{"title":"For Developers","url":"https://docs.storm.tg/developers"},{"title":"📚 Read markets and history","url":"https://docs.storm.tg/developers/api_v2"}],"headings":[{"depth":2,"id":"markets-and-history","title":"Markets and history"},{"depth":2,"id":"paginated-history","title":"Paginated history"},{"depth":2,"id":"trading","title":"Trading"}],"markdown":"# 📚 Read markets and history\n\nRead markets, prices, positions and trading history through the [API reference](/developers/overview). These reads need no API key and use `https://api.storm.tg/api`.\n\n## Markets and history\n\nStart with [List markets](/developers/operations/listmarkets) and [Get protocol configuration](/developers/operations/getprotocolconfiguration). A market is identified by its vAMM address. An `asset` parameter accepts the asset name or configured index. Cache these results instead of fetching them for every request.\n\n`trader` is the user's wallet address for V2 or Smart Account address for V3. Choose the matching address when requesting positions, orders or portfolio history.\n\n## Paginated history\n\n[Order history](/developers/operations/getorderhistory), [position history](/developers/operations/getassetpositionhistory) and [portfolio history](/developers/operations/getportfoliohistory) use the same pagination:\n\n- `data`: records on the current page.\n- `totalCount`: all matching records.\n- `limit`: records per page; `offset`: records to skip.\n\nFor example, use `limit=20&offset=0` for the first page and `limit=20&offset=20` for the next. Keep monetary values returned as strings in that form until you need exact arithmetic.\n\n## Trading\n\nTo place or cancel orders, use the [SDK](sdk.md). See [Submit and track orders](api_v3.md) to confirm execution.\n","text":"📚 Read markets and history Read markets, prices, positions and trading history through the API reference. These reads need no API key and use https://api.storm.tg/api . Markets and history Start with List markets and Get protocol configuration. A market is identified by its vAMM address. An asset parameter accepts the asset name or configured index. Cache these results instead of fetching them for every request. trader is the user's wallet address for V2 or Smart Account address for V3. Choose the matching address when requesting positions, orders or portfolio history. Paginated history Order history, position history and portfolio history use the same pagination: data : records on the current page. totalCount : all matching records. limit : records per page; offset : records to skip. For example, use limit=20&offset=0 for the first page and limit=20&offset=20 for the next. Keep monetary values returned as strings in that form until you need exact arithmetic. Trading To place or cancel orders, use the SDK. See Submit and track orders to confirm execution."}