{"openapi":"3.1.0","info":{"title":"STON.fi API","version":"1.0.0","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 — 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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stonfi-api","description":"oanor gateway"}],"tags":[{"name":"Overview"},{"name":"Pools"},{"name":"Assets"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/overview":{"get":{"operationId":"get_v1_overview","tags":["Overview"],"summary":"STON.fi DEX TVL plus lifetime volume/wallets/trades","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pools":{"get":{"operationId":"get_v1_pools","tags":["Pools"],"summary":"Top TON liquidity pools by volume, APY or liquidity","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"volume (default), apy or liquidity","schema":{"type":"string"},"example":"volume"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sort":"volume","chain":"ton","count":25,"pools":[{"pair":"pTON-BabyDoge","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","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","last_price":662567907.5277911,"base_symbol":"pTON","base_volume":261.6815,"lp_price_usd":0.166371,"pool_address":"EQCVflRjTn91FKGZzy2UTHgLn3hG3TsOlQIsAOPcB57K5gT5","quote_symbol":"FISH","quote_volume":173596553396.307,"base_liquidity":28663.5873,"quote_liquidity":18991573079371.53},{"pair":"pTON-NOTINU","last_price":1204978.439689097,"base_symbol":"pTON","base_volume":10,"lp_price_usd":2.915041,"pool_address":"EQCVby-XmaGCnKHq706iEKacUpYOZDGT7pOc4w6AMSIIrnwq","quote_symbol":"NOTINU","quote_volume":99788644260.8933,"base_liquidity":10.0012,"quote_liquidity":12051233.8052},{"pair":"pTON-@BTC25","last_price":7649077240.381481,"base_symbol":"pTON","base_volume":4.7201,"lp_price_usd":0.044206,"pool_address":"EQAX8VVdiemDa-Y0ew2fWebXW-gUA9QzjM4IkEnZ7WbEF8yR","quote_symbol":"@BTC25","quote_volume":36231328062.1043,"base_liquidity":8793.9151,"quote_liquidity":67265335729312.32},{"pair":"pTON-WINKO","last_price":671297311145,"base_symbol":"pTON","base_volume":0.0288,"lp_price_usd":123.86498,"pool_address":"EQBVzyiHrys8llpe-5P_tNXPLfKL7PMKCB6gbaXyk__yjELt","quote_symbol":"WINKO","quote_volume":19394571721,"base_liquidity":4.0079,"quote_liquidity":2690460350952},{"pair":"pTON-CCAT","last_price":30873563395.133495,"base_symbol":"pTON","base_volume":0.4,"lp_price_usd":1.8e-5,"pool_address":"EQDtmAPQ6D_ql8OOUdCfHdiJeZFTPwuouphkDS736sP_zLQx","quote_symbol":"CCAT","quote_volume":16557226203.8225,"base_liquidity":1.5602,"quote_liquidity":48169773061.276},{"pair":"pTON-FWC26","last_price":2023058.892400466,"base_symbol":"pTON","base_volume":3876.7891,"lp_price_usd":0.002276,"pool_address":"EQAs66cmJqOFdQWzxOgAy9inm5SnbkPWztPY3n6G1AkYn-E0","quote_symbol":"FWC26","quote_volume":6258519375.1756,"base_liquidity":1409.8609,"quote_liquidity":2852231607.307},{"pair":"pTON-👑 ЦАРЬ","last_price":40437096.58086373,"base_symbol":"pTON","base_volume":117.2223,"lp_price_usd":0.521464,"pool_address":"EQAlNow4s2lTmPLh3uqQDhg_fGf4AUXICxOhvVJCvpHvlp3T","quote_symbol":"👑 ЦАРЬ","quote_volume":4842604791.431,"base_liquidity":700.1996,"quote_liquidity":28314040279.28},{"pair":"pTON-PEPE","last_price":195829226.08492345,"base_symbol":"pTON","base_volume":19.3033,"lp_price_usd":0.260538,"pool_address":"EQDDGqjJK9CcdMisxmOTSqLmHoCmmfTBfIua-tFoL0jDBbeU","quote_symbol":"PEPE","quote_volume":4004829778.0018,"base_liquidity":243.0544,"quote_liquidity":47597154944.3543},{"pair":"pTON-Mir","last_price":21279833.269892003,"base_symbol":"pTON","base_volume":216.2175,"lp_price_usd":0.0016,"pool_address":"EQAG4KuT5Fyv8-UlxnSUTQn_tM61teKKcfYoGFbb75SNAiXW","quote_symbol":"Mir","quote_volume":3612390377.8559,"base_liquidity":145.0065,"quote_liquidity":3085713292.2403},{"pair":"pTON-ZILLA","last_price":5925538.234506453,"base_symbol":"pTON","base_volume":1034.8887,"lp_price_usd":0.00129,"pool_address":"EQACMma_0KUBOCl_Orr22wgGZdqE00F8jf3-VcEWIvLjaCpF","quote_symbol":"ZILLA","quote_volume":3384579194.0235,"base_liquidity":109.1893,"quote_liquidity":647005080.6199},{"pair":"pTON-TOGE","last_price":9908118.081030104,"base_symbol":"pTON","base_volume":282.9624,"lp_price_usd":1.138193,"pool_address":"EQBJkk6REO7IO6AO8Dy4vEP8zylT-LyrIoctgs4J9J9kYAzX","quote_symbol":"TOGE","quote_volume":2693183456.9887,"base_liquidity":2172.1909,"quote_liquidity":21522323907.048},{"pair":"pTON-Никуда","last_price":488496.445146002,"base_symbol":"pTON","base_volume":3248.0772,"lp_price_usd":0.00469,"pool_address":"EQCA3w3OIqhd4aXac8ux47X3_tVGXyOizb5_pNlICIr9Jm6N","quote_symbol":"Никуда","quote_volume":2534837335.8319,"base_liquidity":800.3342,"quote_liquidity":390960419.4525},{"pair":"pTON-LAIKA","last_price":122526935.42767124,"base_symbol":"pTON","base_volume":18.1743,"lp_price_usd":0.302202,"pool_address":"EQArHCGDl4ZyD91RpbEFLh9h6sFprOKAx5gUx9SGeOLZ0FnX","quote_symbol":"LAIKA","quote_volume":2207349004.1067,"base_liquidity":1416.9904,"quote_liquidity":173619495568.9787},{"pair":"pTON-SENSE","last_price":757543.362164629,"base_symbol":"pTON","base_volume":4374.3836,"lp_price_usd":0.003755,"pool_address":"EQAghgtGV_RPGfKjWsSwUs1vWiCDn5mCkOJQYtDf6WFHkcty","quote_symbol":"SENSE","quote_volume":1785894076.7168,"base_liquidity":642.5225,"quote_liquidity":486738685.881},{"pair":"pTON-GRAMCOCA","last_price":392449.962812254,"base_symbol":"pTON","base_volume":1305.3384,"lp_price_usd":0.006283,"pool_address":"EQCToLdMH7CXHI0oYL35QhCAouv3fiHzqjdweYkOGRiNZ8uK","quote_symbol":"GRAMCOCA","quote_volume":1662878828.9139,"base_liquidity":715.8018,"quote_liquidity":280916379.0119},{"pair":"pTON-CHILLPOVEL","last_price":294949.796161783,"base_symbol":"pTON","base_volume":803.2643,"lp_price_usd":0.006283,"pool_address":"EQAUsEe_bwfv3hNTYjgSJCwBag9zlJ_NfO-UnjeEDEEoHlL5","quote_symbol":"CHILLPOVEL","quote_volume":1454817419.6894,"base_liquidity":652.6694,"quote_liquidity":192504701.858},{"pair":"pTON-DECAT","last_price":404530.911727584,"base_symbol":"pTON","base_volume":3340.0221,"lp_price_usd":0.006283,"pool_address":"EQBGiFvf-im4zaw_g-3o0iC2TbBNaCrw5EpKjKP8wUUQYAw-","quote_symbol":"DECAT","quote_volume":1417671155.9603,"base_liquidity":1929.0085,"quote_liquidity":780343568.9064},{"pair":"pTON-RINAT","last_price":487614.411620901,"base_symbol":"pTON","base_volume":3792.3546,"lp_price_usd":0.005261,"pool_address":"EQBPzTdSiYLW7TL-xA3NIFGUDW-irR5xHAUi1vTkTlOPSuWn","quote_symbol":"RINAT","quote_volume":1399187682.859,"base_liquidity":913.033,"quote_liquidity":445208052.6114},{"pair":"pTON-CHERRY","last_price":126525.111770732,"base_symbol":"pTON","base_volume":10675.4417,"lp_price_usd":11.610306,"pool_address":"EQB-2nOKHN3EHTd82iASHdSbW3QIrjGGPdPYgCtX0okWsd_2","quote_symbol":"CHERRY","quote_volume":1390199717.5009,"base_liquidity":52871.1558,"quote_liquidity":6689528902.169},{"pair":"pTON-GRAMDOG","last_price":97659.050179203,"base_symbol":"pTON","base_volume":16296.7676,"lp_price_usd":0.010286,"pool_address":"EQB-h446AV-57gfAtrjgWRgtLd78FSkrhw1oKOx71iYaqeH9","quote_symbol":"GRAMDOG","quote_volume":1379437508.4488,"base_liquidity":1760.8192,"quote_liquidity":171959932.1595},{"pair":"pTON-TONMINATOR","last_price":496465.14812878,"base_symbol":"pTON","base_volume":1087.7351,"lp_price_usd":0.004473,"pool_address":"EQD9AFJ98CKCEVSceKMCLsjq32EoDrOz4OmGheSR8fDz4PF6","quote_symbol":"TONMINATOR","quote_volume":1242161938.9379,"base_liquidity":651.8414,"quote_liquidity":323616515.7781},{"pair":"pTON-PIPPIN","last_price":492307.375730313,"base_symbol":"pTON","base_volume":931.8792,"lp_price_usd":0.006283,"pool_address":"EQBqmYzvJVbe8d_N8nFR9twi8XpVsvSd3O-iGrrxjs7YkF51","quote_symbol":"PIPPIN","quote_volume":1169391421.9104,"base_liquidity":638.7195,"quote_liquidity":314446343.1428},{"pair":"pTON-KUNUK","last_price":39501310.22845901,"base_symbol":"pTON","base_volume":28.2796,"lp_price_usd":0.000514,"pool_address":"EQDDkM-_df_OcFl4Qo0qL21HJkD6SjPJwCzFWwg4nHE1mK_4","quote_symbol":"KUNUK","quote_volume":1147001722.7264,"base_liquidity":405.6867,"quote_liquidity":16025155299.8462}],"source":"STON.fi"},"meta":{"timestamp":"2026-06-10T22:56:49.106Z","request_id":"6d0a220c-a728-4dc9-bbd5-3cd349ba6bb5"},"status":"ok","message":"Pools retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/assets":{"get":{"operationId":"get_v1_assets","tags":["Assets"],"summary":"Search the token registry by symbol","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Token symbol (min 2 chars)","schema":{"type":"string"},"example":"TON"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","symbol":"TON","decimals":9,"price_usd":1.57,"contract_address":"EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c"},{"name":"WTON","symbol":"WTON","decimals":9,"price_usd":1.57,"contract_address":"EQDQoc5M3Bh8eWFephi9bClhevelbZZvWhkqdo80XuY_0qXv"},{"name":"TON USDT","symbol":"TON USDT","decimals":9,"price_usd":1.0667700573675933,"contract_address":"EQDu_xBk0-0bfIVLUA5kkT1a3d7Q6r969fCUv3hldE_gX0oK"},{"name":"ANTON","symbol":"ANTON","decimals":9,"price_usd":0.9970452371087121,"contract_address":"EQCeV9-oxVxJ8oPvw46Vz2HDAVMBY5puENJAnhlUI3np6nKJ"},{"name":"STON","symbol":"STON","decimals":9,"price_usd":0.5514905526045155,"contract_address":"EQA2kCVNwVsil2EM2mB0SkXytxCqQjS4mttjDpnXmwG9T6bO"},{"name":"Toncast","symbol":"TCAST","decimals":9,"price_usd":0.13768446719265293,"contract_address":"EQCwIlIRZRVzdwS-iY7QJngnVCU8UMKfPhWr_KkZoQ6Mckju"},{"name":"AiTon","symbol":"AiT","decimals":9,"price_usd":0.12171499103937704,"contract_address":"EQCil_MCr2VF7YScB4gIOM5rqi-iO7_BgycBKK2zITyhM6RN"},{"name":"Gatto Game Token","symbol":"GTON","decimals":9,"price_usd":0.09334254121895624,"contract_address":"EQDK-ITrmdWfns6Ibse9xdw_K5VARAihGiaMev0kkqEzU9-m"},{"name":"GEMSTON","symbol":"GEMSTON","decimals":9,"price_usd":0.08700372285771543,"contract_address":"EQBX6K9aXVl3nXINCyPPL86C4ONVmQ8vK360u6dykFKXpHCa"},{"name":"CRYPTON","symbol":"CRYPTON","decimals":9,"price_usd":0.05257808530911146,"contract_address":"EQD36Lxp6p4FMzHQThWzvFNaqhbT8Qip4rMF1NYjCSgY6ksE"},{"name":"Ton Raffles Token","symbol":"RAFF","decimals":9,"price_usd":0.029938641112045618,"contract_address":"EQCJbp0kBpPwPoBG-U5C-cWfP_jnksvotGfArPF50Q9Qiv9h"},{"name":"JetTon","symbol":"JETTON","decimals":9,"price_usd":0.027937101860582014,"contract_address":"EQAQXlWJvGbbFfE8F3oS8s87lIgdovS455IsWFaRdmJetTon"},{"name":"TONDEV","symbol":"TONDEV","decimals":9,"price_usd":0.026492574902911497,"contract_address":"EQDKMh511DOn02mL0nf0JrND0TlkUKmos17eK9zKyGAsjS1K"},{"name":"Your Uncle Mows Your Tuna","symbol":"TONTONTONTONDTONTHON","decimals":9,"price_usd":0.02072144627294263,"contract_address":"EQCPKZmEJgvmkCacqIXJZFRWmzFjs59DnkOOqujvos848-6X"},{"name":"MyTonWallet Coin","symbol":"MY","decimals":9,"price_usd":0.0206417607626292,"contract_address":"EQCFVNlRb-NHHDQfv3Q9xvDXBLJlay855_xREsq5ZDX6KN-w"}],"source":"STON.fi"},"meta":{"timestamp":"2026-06-10T22:56:49.731Z","request_id":"4f5ba3a7-c954-47fd-9f8e-a46b7cdde26b"},"status":"ok","message":"Assets retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2200,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":58000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2600,"monthly_call_quota":320000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6000,"monthly_call_quota":1950000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stonfi-api"}