{"openapi":"3.1.0","info":{"title":"TRON (TRX) On-Chain API","version":"1.0.0","description":"Live on-chain data from the TRON blockchain (TRX), the network that settles the largest share of the world's USDT (Tether) transfers, served straight from TRON's public TronGrid API — no key, nothing cached. The account endpoint returns any address's state: its TRX balance, when the account was created, and its holdings of the major TRC20 stablecoins and tokens (USDT, USDC, USDD and more) decoded to real amounts. The transfers endpoint returns the account's most recent TRC20 token transfers — the raw USDT flow that makes TRON the backbone of crypto payments — each with the counterparty, token, amount, direction and time. The transactions endpoint returns the account's recent system transactions with the type, result, block and time. The network endpoint returns the live state of the chain: the latest block, its timestamp, the producing super-representative and the block's transaction count. Everything is read live from TronGrid, nothing stored. This is the TRON on-chain layer for any wallet, explorer, payments, stablecoin or analytics app. Distinct from the XRP Ledger, Stellar, EVM and Solana on-chain APIs and from price feeds — this is TRON account state, TRC20/USDT transfers, transactions and block production. 4 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tron-api","description":"oanor gateway"}],"tags":[{"name":"TRON"},{"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":["TRON"],"summary":"An address's TRX + TRC20 balances","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"TRON base58 address (T...)","schema":{"type":"string"},"example":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"exists":true,"source":"TRON","tokens":[{"symbol":"WIN","balance":585420653.609151,"contract":"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7"},{"symbol":"USDT","balance":620.907555,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}],"address":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","created_at":"2018-06-28T06:43:57.000Z","balance_trx":14534.104748,"trc20_token_count":881},"meta":{"timestamp":"2026-06-09T11:38:10.931Z","request_id":"a3612ab4-7f84-4722-8d16-9440ad290c24"},"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/network":{"get":{"operationId":"get_v1_network","tags":["TRON"],"summary":"Live TRON chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"block":83445298,"source":"TRON","version":35,"block_id":"0000000004f94632143bc44d3e3bee24877b930ebacdf207046e80c71c23941e","timestamp":"2026-06-09T11:38:06.000Z","witness_address":"411c8163d2a981b90481dcc8ca34c0f837b3305bc6","transaction_count":1105},"meta":{"timestamp":"2026-06-09T11:38:11.352Z","request_id":"56a4a35d-80a3-4ec1-bf5f-d8b380f8d219"},"status":"ok","message":"Network state 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":["TRON"],"summary":"Recent system transactions","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"TRON base58 address (T...)","schema":{"type":"string"},"example":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR"},{"name":"limit","in":"query","required":false,"description":"Max transactions (1-100, default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"TRON","address":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","transactions":[{"time":"2026-06-07T02:23:33.000Z","type":"TransferAssetContract","block":83376625,"tx_id":"4c61c24677575a04cfba7bb5f8021bf3ddc71deedc92940b13b98ebee8b10486","result":"SUCCESS","contract_count":1},{"time":"2026-03-18T17:40:45.000Z","type":"UnDelegateResourceContract","block":81062875,"tx_id":"3c9bedb95063fa3b6d42c1f1d9b67adb2ca0801a5643974ef2ea82310d1fc99e","result":"SUCCESS","contract_count":1},{"time":"2026-03-18T16:40:42.000Z","type":"DelegateResourceContract","block":81061674,"tx_id":"720350df0c9aa4b5f859eaeaec1921cd02b048610d586d3419f289aa7fc5cdb3","result":"SUCCESS","contract_count":1},{"time":"2026-03-11T11:01:33.000Z","type":"TransferContract","block":80853351,"tx_id":"4270cd48d26b9d21729d43abbbbb7b0faf52978443254c5dee4bd846e914c9ee","result":"SUCCESS","contract_count":1},{"time":"2026-02-08T17:37:54.000Z","type":"TransferAssetContract","block":79969218,"tx_id":"cbdb4e4cff5d85d05315761fd8cd9697962e9e05333a92813e6bb35ccc00d27a","result":"SUCCESS","contract_count":1},{"time":"2026-01-20T23:53:39.000Z","type":"TransferContract","block":79429789,"tx_id":"882b00788b5ab95d54fc253c7f3c5dcee4531e32108670fa5e950fcbdaee6065","result":"SUCCESS","contract_count":1},{"time":"2026-01-10T13:29:24.000Z","type":"TransferContract","block":79129541,"tx_id":"f3f13e89965321ab266e5770d25a30964ed2ddd7aa6c76fac46dde8b2db1a44b","result":"SUCCESS","contract_count":1},{"time":"2026-01-08T15:33:42.000Z","type":"TransferContract","block":79074443,"tx_id":"c636dd8147b43a37eae1860550af92345abba92a0f4223ec614e2a16e4d66568","result":"SUCCESS","contract_count":1},{"time":"2026-01-08T15:32:06.000Z","type":"TransferContract","block":79074411,"tx_id":"ea1b8129c5c336cba58d7d2c8d943f1703e3b522bd5a6c2818c5a225b6787d92","result":"SUCCESS","contract_count":1},{"time":"2026-01-01T17:07:27.000Z","type":"TransferContract","block":78874774,"tx_id":"82f5797a3de2312dea791dd9663971181f977b77ab192bff32b7c4128be819d4","result":"SUCCESS","contract_count":1}]},"meta":{"timestamp":"2026-06-09T11:38:11.567Z","request_id":"da4cb9a6-3deb-4f23-92df-2afd09a919b2"},"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/transfers":{"get":{"operationId":"get_v1_transfers","tags":["TRON"],"summary":"Recent TRC20 token transfers","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"TRON base58 address (T...)","schema":{"type":"string"},"example":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR"},{"name":"limit","in":"query","required":false,"description":"Max transfers (1-100, default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"TRON","address":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","transfers":[{"to":"TGjmQxcRHwPJ3NKfPNs1zRkGWJDmMDQiE6","from":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","time":"2026-04-09T02:11:27.000Z","type":"Transfer","token":"USDT","tx_id":"cafc467846af002f34e5459f81720304c8cd89903773c700b7aaaf00066e2496","amount":0,"contract":"TQgktYKWXoVmGTJMMfJFDQxDDRyup9nDSt","direction":"out","value_raw":"0"},{"to":"TGjmQxcRHwPJ3NKfPNs1zRkGWJDmMDQiE6","from":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","time":"2026-04-09T02:11:27.000Z","type":"Transfer","token":"USDT","tx_id":"cafc467846af002f34e5459f81720304c8cd89903773c700b7aaaf00066e2496","amount":0,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"out","value_raw":"0"},{"to":"TGjmQxcRHwPJ3NKfPNs1zRkGWJDmMDQiE6","from":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","time":"2026-04-09T00:32:21.000Z","type":"Transfer","token":"USDT","tx_id":"2c6ecdfe633a75ac950e87f922c815304d62510fa1e155b8724da05402683e4a","amount":1000,"contract":"TQgktYKWXoVmGTJMMfJFDQxDDRyup9nDSt","direction":"out","value_raw":"1000000000"},{"to":"TGjmQxcRHwPJ3NKfPNs1zRkGWJDmMDQiE6","from":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","time":"2026-04-09T00:23:45.000Z","type":"Transfer","tx_id":"f24db24f32b7f4340414c480ad5397134ffd375efa97c089b0912cc64d9d8544","amount":1000,"direction":"out","value_raw":"1000000000"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TJtEySoVuAkk3xwXghLgrUFVKSMq9JkE18","time":"2026-03-24T10:15:30.000Z","type":"Transfer","token":"USDT","tx_id":"56e240200b47565ead8701f531763a9838665b8e2716ed6a6253d12fe41b9b38","amount":1,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"1000000"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TWBPGLwQw2EbqYLLw1DJnTDt2ZQ9yJW1JJ","time":"2026-02-14T10:06:51.000Z","type":"Transfer","token":"USDT","tx_id":"366ee826bd6583f288eb18fa594ea4a5656ac0d0288b4c1a8ebc3f68e047a993","amount":9,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"9000000"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TDYaCtd8jmnC6useu25moHcSP535rwZYag","time":"2026-01-20T23:53:33.000Z","type":"Transfer","token":"USDT","tx_id":"e8271c2ad36b3eee1582b8936db908ce842c68aaaef75a5a6e8b23d6618436ad","amount":1,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"1000000"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TNQFUghP4TBo6sqS9Exi7P538jwHHap4ma","time":"2025-04-21T21:54:36.000Z","type":"Approval","token":"USDT","tx_id":"04a2a6ea7490054c8d85b2527a9a7bfe9a024f5704a321639391fd5972553806","amount":1.157920892373162e+71,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"115792089237316195423570985008687907853269984665640564039457584007913129639935"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TNQFUghP4TBo6sqS9Exi7P538jwHHap4ma","time":"2025-04-21T21:42:51.000Z","type":"Approval","token":"USDT","tx_id":"d276009f17c0c0192f566721acc769adfb5461c43d69cc1b59ea9048a34debce","amount":1000000,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"1000000000000"},{"to":"TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR","from":"TNQFUghP4TBo6sqS9Exi7P538jwHHap4ma","time":"2025-04-20T23:59:09.000Z","type":"Approval","token":"USDT","tx_id":"0a8a5caaa454edd99f3594b6c14120f2ad9dedd2e6e9c2acaa743d39c9e54c53","amount":1.157920892373162e+71,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","direction":"in","value_raw":"115792089237316195423570985008687907853269984665640564039457584007913129639935"}]},"meta":{"timestamp":"2026-06-09T11:38:11.980Z","request_id":"94031225-f6cb-4859-b549-5b64effdbb3b"},"status":"ok","message":"Transfers 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"TronGrid public API (live)","service":"tron-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/account":"An address's TRX + TRC20 token balances (address=TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR).","GET /v1/network":"Live TRON chain state: latest block, timestamp, super-representative, tx count.","GET /v1/transfers":"An address's recent TRC20 token transfers — USDT flow (address=, limit).","GET /v1/transactions":"An address's recent system transactions (address=, limit)."},"description":"Live on-chain data from the TRON blockchain via the public TronGrid API: any address's state (TRX balance, creation time, and decoded balances of the major TRC20 stablecoins/tokens — USDT, USDC, USDD and more); the account's recent TRC20 token transfers (counterparty, token, amount, direction, time) — the raw USDT flow TRON is known for; the account's recent system transactions (type, result, block, time); and the live chain state (latest block, timestamp, producing super-representative, transaction count). Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, EVM and Solana on-chain APIs and from price feeds — this is TRON account state, TRC20/USDT transfers, transactions and block production.","latest_block":83445299,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:38:12.355Z","request_id":"c7a73e41-b31e-4aa2-8444-661b5ed6d96a"},"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":4000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1100,"monthly_call_quota":105000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3300,"monthly_call_quota":620000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8000,"monthly_call_quota":3600000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tron-api"}