Current balances of an address
Returns every token held by the address with its symbol, amount and USD value where a price is known. Tokens are ordered by relevance: TRX and major stablecoins first, then verified tokens with a price, then the rest.
The balance field is not the chain's balance at this second: it is the ledger value at the block shown in as_of_block. Balances are rebuilt from indexed chain events, and that index advances only to a block every writer has confirmed, so it trails the chain head — measured over 20 minutes on 6 September 2026: about 1 minute at best, 2 minutes typically, and up to 6 minutes at the peak of its sawtooth. On an address that moved funds within that window the amount can be off in either direction. live=true applies the remaining tail of transfer events for 30-80 ms, which narrows the gap without closing it, since it covers neither fees nor TRC10 tokens. The field that always holds the chain's present value is node_balance. On an address quiet for longer than the current lag there is nothing to trail and the answer is exact.
Historical endpoints do not have this caveat at all: /at and /at-block describe a point the index passed long ago.
Authorizations
API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.
Parameters
Header Parameters
An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.
"203.0.113.10""ipv4"Path Parameters
TRON address in base58, exactly 34 characters.
"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"3434Query Parameters
Apply the tail of transfer events between as_of_block and the chain head on the fly. Narrows the gap to the chain but does not close it: as_of_block does not move, fees are not accounted for, and TRC10 tokens are skipped. Adds 30-80 ms.
falseHide tokens classified as deceptive. TRX and USDT are never hidden.
falseResponses
Balances of the address.