{"openapi":"3.1.0","info":{"title":"TON Blockchain API","version":"1.0.0","description":"Live on-chain data from The Open Network (TON / Toncoin), the layer-1 blockchain integrated with Telegram — no key, nothing cached, nothing stored. The network endpoint returns the latest masterchain block (the chain tip). The account endpoint returns any TON address's balance (in TON and nanoTON), account state and last-transaction reference. The transactions endpoint returns an address's most recent transactions with counterparties, value, fee and time. Addresses accept raw (0:.. / -1:..) or user-friendly (EQ.. / UQ..) form. This is live blockchain and network data straight from the public TON node API — distinct from the exchange-ticker, price and market APIs in the catalogue. Built for TON wallets, explorers, dashboards and on-chain analytics.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ton-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Transactions"},{"name":"Network"},{"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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"Balance, state and last transaction for an address","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"TON address (raw 0:../-1:.. or EQ../UQ..)","schema":{"type":"string"},"example":"-1:5555555555555555555555555555555555555555555555555555555555555555"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"state":"active","source":"toncenter","address":"-1:5555555555555555555555555555555555555555555555555555555555555555","is_active":true,"balance_ton":2475.547956013,"balance_nano":"2475547956013","last_transaction":{"lt":"83036841000003","hash":"SQUm1aFZ9ev8M5dlwmeIeCvawF45kmEO8l42z6PqD+s="}},"meta":{"timestamp":"2026-06-11T16:47:25.106Z","request_id":"fa0e7fe4-3c65-4e99-b4a4-2fc954329831"},"status":"ok","message":"Account 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/transactions":{"get":{"operationId":"get_v1_transactions","tags":["Transactions"],"summary":"Recent transactions for an address","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"TON address","schema":{"type":"string"},"example":"-1:3333333333333333333333333333333333333333333333333333333333333333"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"toncenter","address":"-1:3333333333333333333333333333333333333333333333333333333333333333","transactions":[{"lt":"83036842000002","hash":"0tG9ORdOQq/MDRZ7qcrhDi+H8banppmvtuP6ZQepkzg=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"in_from":"Ef8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAU","out_count":0,"in_value_ton":2.702524941,"out_value_ton":0},{"lt":"83036842000001","hash":"Xct8D5Bww8LfGTAVnpAB/6ht4Vn/D7plcbkm14G/NjM=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"out_count":0,"out_value_ton":0},{"lt":"83036841000002","hash":"yIUs0+xoq3g+HnlVbQ7aBAh6JeEbrXLVmCRdzKcROso=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"in_from":"Ef8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAU","out_count":0,"in_value_ton":2.70161076,"out_value_ton":0},{"lt":"83036841000001","hash":"liDNUmRxIBj6/K1uvRcAqurct9NKwntkhHdtKroZtI0=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"out_count":0,"out_value_ton":0},{"lt":"83036840000002","hash":"WrDMnSw/tD+IAFwsAcpxurqEjtJ8gDba4OnnkXYrj3E=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"in_from":"Ef8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAU","out_count":0,"in_value_ton":2.701753065,"out_value_ton":0},{"lt":"83036840000001","hash":"2LRLPLmMl4M4d6DlHqDXWJHF6XsvrGwuY6eI23PPuN8=","time":"2026-06-11T16:47:24.000Z","utime":1781196444,"fee_ton":0,"out_count":0,"out_value_ton":0},{"lt":"83036839000002","hash":"yf/iOyjmGQfGAcz/ICGMfHXjBTMxyOfH9sU+7oHvp2o=","time":"2026-06-11T16:47:23.000Z","utime":1781196443,"fee_ton":0,"in_from":"Ef8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAU","out_count":0,"in_value_ton":2.701091511,"out_value_ton":0},{"lt":"83036839000001","hash":"MNDadW+8jNky7R3IMiNUUNArXa4hwAYyanpl4xhsfD4=","time":"2026-06-11T16:47:23.000Z","utime":1781196443,"fee_ton":0,"out_count":0,"out_value_ton":0},{"lt":"83036838000002","hash":"UjQ3MdCnYJRpxJQnsBciXzsskxq7JUqmqbjP4gCkEB8=","time":"2026-06-11T16:47:23.000Z","utime":1781196443,"fee_ton":0,"in_from":"Ef8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAU","out_count":0,"in_value_ton":2.703563745,"out_value_ton":0},{"lt":"83036838000001","hash":"HyrHjNHJeSwg96riot3vQNH+hD/f188XBO9Bz8/TnI8=","time":"2026-06-11T16:47:23.000Z","utime":1781196443,"fee_ton":0,"out_count":0,"out_value_ton":0}]},"meta":{"timestamp":"2026-06-11T16:47:25.261Z","request_id":"0449d77c-b5c8-4e09-8d8f-50b4f4da86d3"},"status":"ok","message":"Transactions 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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Latest TON masterchain block (chain tip)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"TON","source":"toncenter","latest_block":{"seqno":72672042,"shard":"-9223372036854775808","root_hash":"dSYuOAOe6oTMXS5mYTdTYPZWIvIfsGZi0emqJoZyL68=","workchain":-1}},"meta":{"timestamp":"2026-06-11T16:47:29.242Z","request_id":"925e22ea-1bb6-4913-a483-5e9784238d42"},"status":"ok","message":"Network info 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":{"note":"Balances are in TON (1 TON = 1e9 nanoTON). Addresses accept raw (0:../-1:..) or user-friendly (EQ../UQ..) form. Data is cached briefly to protect the keyless rate-limited upstream; it only changes per block (~5s).","source":"toncenter public API (toncenter.com/api/v2, live)","service":"ton-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/account":"Balance, state and last transaction for an address (address=EQ.. or 0:..).","GET /v1/network":"Latest TON masterchain block (the chain tip).","GET /v1/transactions":"Recent transactions for an address (address=..&limit=10, max 50)."},"description":"Live on-chain data from The Open Network (TON / Toncoin), the blockchain integrated with Telegram, read from the public toncenter API. The network endpoint returns the latest masterchain block; the account endpoint returns any address's balance (TON and nanoTON), state and last-transaction reference; the transactions endpoint returns an address's most recent transactions with counterparties, value, fee and time. Live, no key, nothing stored. Blockchain/network data, distinct from the exchange-ticker and market APIs.","latest_seqno":72672042,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:47:29.332Z","request_id":"17c8e6ce-69f4-491f-aeb8-8e27a8667ec4"},"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":20000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":885,"monthly_call_quota":265000,"rps_limit":10,"hard_limit":true},{"slug":"growth","name":"Growth","price_cents_month":2485,"monthly_call_quota":1225000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5810,"monthly_call_quota":4380000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ton-api"}