# TRON (TRX) On-Chain API > 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. ## 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/tron-api/..." ``` ## Pricing - **Free** (Free) — 4,000 calls/Mo, 5 req/s - **Starter** ($11/Mo) — 105,000 calls/Mo, 12 req/s - **Pro** ($33/Mo) — 620,000 calls/Mo, 30 req/s - **Mega** ($80/Mo) — 3,600,000 calls/Mo, 80 req/s ## Endpoints ### TRON #### `GET /v1/account` — An address's TRX + TRC20 balances **Parameters:** - `address` (query, required, string) — TRON base58 address (T...) Example: `TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tron-api/v1/account?address=TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR" ``` **Response:** ```json { "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 } ``` #### `GET /v1/network` — Live TRON chain state **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tron-api/v1/network" ``` **Response:** ```json { "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 } ``` #### `GET /v1/transactions` — Recent system transactions **Parameters:** - `address` (query, required, string) — TRON base58 address (T...) Example: `TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR` - `limit` (query, optional, string) — Max transactions (1-100, default 20) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tron-api/v1/transactions?address=TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR&limit=10" ``` **Response:** ```json { "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 }, { …(truncated, see openapi.json for full schema) ``` #### `GET /v1/transfers` — Recent TRC20 token transfers **Parameters:** - `address` (query, required, string) — TRON base58 address (T...) Example: `TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR` - `limit` (query, optional, string) — Max transfers (1-100, default 20) Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tron-api/v1/transfers?address=TNaRAoLUyYEV2uF7GUrzSjRQTU8v5ZJ5VR&limit=10" ``` **Response:** ```json { "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": "2c6ecdfe633a75ac …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/tron-api/v1/meta" ``` **Response:** ```json { "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.355 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/tron-api OpenAPI spec: https://www.oanor.com/api/tron-api/openapi.json