TRON HTTP API Reference: Essential Endpoints for Developers

TRON full nodes expose a JSON-over-HTTP API similar in spirit to Ethereum's JSON-RPC but method-oriented — wallet/getaccount, wallet/createtransaction, wallet/triggersmartcontract, and dozens more. TronGrid hosts load-balanced endpoints so most developers never run their own node.

This reference lists the endpoints you will use daily for balances, transactions, contract calls, and event indexing.

Base URLs

All paths append /wallet/... or use /v1/... REST wrappers.

Register API key: trongrid.io — header TRON-PRO-API-KEY.

Deep dive: TronGrid API guide.

Request format

Most wallet/* endpoints:

POST /wallet/getaccount
Content-Type: application/json

{"address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7", "visible": true}

visible: true → Base58 addresses. false → hex with 41 prefix.

Account endpoints

getaccount example

curl -X POST https://api.trongrid.io/wallet/getaccount \
  -H "TRON-PRO-API-KEY: $KEY" \
  -d '{"address":"TYourAddress","visible":true}'

TRC-20 balances use contract calls or v1 API — query TRC-20 balance.

Transaction endpoints

Verify flow: verify transaction API.

const info = await fetch('https://api.trongrid.io/wallet/gettransactioninfobyid', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'TRON-PRO-API-KEY': key },
  body: JSON.stringify({ value: txid })
}).then(r => r.json());

// info.receipt.result === 'SUCCESS'

Smart contract endpoints

Guide: trigger smart contract.

v1 REST API

Higher-level REST at /v1/:

Example TRC-20 history:

GET /v1/accounts/TAddr.../transactions/trc20?only_confirmed=true&contract_address=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&limit=20

Event endpoints

GET /v1/contracts/{contract}/events?event_name=Transfer&only_confirmed=true

Filter client-side for to address or use block timestamp filters.

Event listeners patterns.

Block endpoints

Useful for confirmation counting in payment systems — accept USDT payments.

Signing workflow

Typical server flow:

1. createtransaction or triggersmartcontract → unsigned tx
2. Sign with private key (TronWeb trx.sign)
3. broadcasttransaction → txid

TronWeb wraps all three — TronWeb introduction.

Rate limits and errors

Production: cache reads, websocket alternatives limited — poll with discipline.

TronWeb vs raw HTTP

Security

• Never POST private keys to TronGrid
• Sign locally or HSM
• API key is not secret like private key but don't commit to Git
• Validate all addresses server-side — check address valid

Testnet differences

Same endpoint paths, different base URL. USDT contract address differs on testnet — use faucet tokens.

Mainnet vs testnet.

Related guides

• TronGrid API guide
• Query TRC-20 balance API
• Send USDT programmatically
• TronScan guide

FAQ

What is the base URL for TRON mainnet API?

https://api.trongrid.io for TronGrid. Self-hosted nodes use same paths on your host.

Do I need an API key for TronGrid?

Recommended for production — higher rate limits via TRON-PRO-API-KEY header.

Is TRON API REST or JSON-RPC?

Hybrid — legacy wallet/* POST JSON plus v1 REST resources. Not identical to Ethereum JSON-RPC.

How do I get USDT balance via API?

triggerconstantcontract balanceOf(address) or v1 trc20 account token list endpoints.

Where is official API documentation?

TronGrid docs at developers.tron.network and trongrid.io — this article summarizes common endpoints.