# STON.fi API > Live data from STON.fi, the largest decentralised exchange on TON (The Open Network, the Telegram-native blockchain). The overview endpoint returns the DEX's current total value locked plus lifetime volume, wallets and trades. The pools endpoint returns the top liquidity pools by volume, APY or liquidity — each with its token pair, last price, base/quote volume and liquidity, LP token USD price and APY. The assets endpoint searches STON.fi's token registry by symbol and returns each token's live USD price, decimals and contract address. Read live from STON.fi, nothing stored. The only TON-native DeFi feed here — distinct from Ethereum, Solana and Sui DEX feeds — this is STON.fi's own TON DEX pool, volume/APY and token-pricing layer. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/stonfi-api/..." ``` ## Pricing - **Free** (Free) — 2,200 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 58,000 calls/Mo, 15 req/s - **Pro** ($26/Mo) — 320,000 calls/Mo, 40 req/s - **Scale** ($60/Mo) — 1,950,000 calls/Mo, 120 req/s ## Endpoints ### Overview #### `GET /v1/overview` — STON.fi DEX TVL plus lifetime volume/wallets/trades **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stonfi-api/v1/overview" ``` **Response:** ```json { "data": { "note": "tvl is current; cumulative_volume_usd, unique_wallets and total_trades are lifetime totals since inception.", "chain": "ton", "since": "2022-11-18 14:19:42", "until": "2026-06-10 22:56:43", "source": "STON.fi", "tvl_usd": 28667606.98, "protocol": "STON.fi", "total_trades": 34969996, "unique_wallets": 5786757, "cumulative_volume_usd": 3907696449.85 }, "meta": { "timestamp": "2026-06-10T22:56:48.865Z", "request_id": "78a431e9-f716-45fc-863f-85bfb1924225" }, "status": "ok", "message": "Overview retrieved successfully", "success": true } ``` ### Pools #### `GET /v1/pools` — Top TON liquidity pools by volume, APY or liquidity **Parameters:** - `sort` (query, optional, string) — volume (default), apy or liquidity Example: `volume` - `limit` (query, optional, string) — Max results (1-100) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stonfi-api/v1/pools?sort=volume&limit=25" ``` **Response:** ```json { "data": { "sort": "volume", "chain": "ton", "count": 25, "pools": [ { "pair": "pTON-BabyDoge", "apy_pct": null, "last_price": 5024884627.867067, "base_symbol": "pTON", "base_volume": 704.9203, "lp_price_usd": 4.5e-5, "pool_address": "EQCBMaivtspMOH1xD4HeUUa86osOO1u9ReubYUgZ1knxHH8s", "quote_symbol": "BabyDoge", "quote_volume": 3612303592196.7646, "base_liquidity": 29425.1672, "quote_liquidity": 147858070246355.8 }, { "pair": "pTON-Shiba", "apy_pct": null, "last_price": 118920587439.59145, "base_symbol": "pTON", "base_volume": 8.639, "lp_price_usd": 0.009303, "pool_address": "EQC0_AL1-NERHKjTJKGYevQ77DsrmmDLkxt6fWFVjwwy5fmx", "quote_symbol": "Shiba", "quote_volume": 1029919829776.4467, "base_liquidity": 5741.6812, "quote_liquidity": 682804095752100.9 }, { "pair": "pTON-FISH", "apy_pct": null, "last_price": 662567907.5277911, "base_symbol": "pTON", "base_volume": 261.6815, "lp_price_usd": 0.166371, "pool_address": "EQCVflRjTn9 …(truncated, see openapi.json for full schema) ``` ### Assets #### `GET /v1/assets` — Search the token registry by symbol **Parameters:** - `q` (query, required, string) — Token symbol (min 2 chars) Example: `TON` - `limit` (query, optional, string) — Max results (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stonfi-api/v1/assets?q=TON&limit=20" ``` **Response:** ```json { "data": { "chain": "ton", "count": 20, "query": "TON", "assets": [ { "name": "TON xStock", "symbol": "TONXx", "decimals": 8, "price_usd": 3.17, "contract_address": "EQCVmpJ_UkQBs_3O8atqOtSP-HvTKYmPG02C6Gc6fs7sMwAM" }, { "name": "Staked TON", "symbol": "stTON", "decimals": 9, "price_usd": 1.791858122132956, "contract_address": "EQDNhy-nxYFgUqzfUzImBEP67JqsyMIcyk2S5_RwNNEYku0k" }, { "name": "Hipo Staked TON", "symbol": "hTON", "decimals": 9, "price_usd": 1.7846616388828902, "contract_address": "EQDPdq8xjAhytYqfGSX8KcFWIReCufsB9Wdg0pLlYSO_h76w" }, { "name": "Tonstakers TON", "symbol": "tsTON", "decimals": 9, "price_usd": 1.771561289512606, "contract_address": "EQC98_qAmNEptUtPc7W6xdHh_ZHrBUFpw5Ft_IzNU20QAJav" }, { "name": "KTON", "symbol": "KTON", "decimals": 9, "price_usd": 1.6100043347600002, "contract_address": "EQBuIhXNNkWf9AW9miNGNTSO_uFZ23ejfIWrieXge5f733mw" }, { "name": "TON", "sym …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stonfi-api/v1/meta" ``` **Response:** ```json { "data": { "source": "STON.fi API (api.ston.fi, live)", "service": "stonfi-api", "tvl_usd": 28667606.98, "endpoints": { "GET /v1/meta": "This document.", "GET /v1/pools": "Top liquidity pools by volume/apy/liquidity (sort=volume, limit=25).", "GET /v1/assets": "Search the token registry by symbol — price, decimals, address (q=TON, limit=20).", "GET /v1/overview": "STON.fi DEX current TVL plus lifetime volume, wallets and trades." }, "description": "Live data from STON.fi, the largest decentralised exchange on TON (The Open Network, the Telegram-native blockchain). The overview endpoint returns the DEX's current total value locked plus lifetime volume, wallets and trades; the pools endpoint returns the top liquidity pools by volume, APY or liquidity — token pair, last price, 24h base/quote volume and liquidity, LP token USD price and APY; the assets endpoint searches STON.fi's token registry by symbol and returns each token's live USD price, decimals and contract address. Live, no key, nothing stored. The only TON-native DeFi feed here — distinct from Ethereum, Solana and Sui DEX feeds — this is STON.fi's own TON DEX pool, volume/APY and token-pricing layer.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-10T22:56:55.100Z", "request_id": "3c740505-71a9-4de3-9935-87c848a06fc1" }, "status": "ok", "message": "Meta", …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/stonfi-api OpenAPI spec: https://www.oanor.com/api/stonfi-api/openapi.json