Balances at a block or a moment

GET

/balances/{address}/at-block

Returns the balances at a precise point: either a block height or a UTC timestamp resolved to the nearest block. Exactly one of block or ts is required.
The answer is exact for that point. Asking for a block the index has not reached yet is the only case that can surprise you — check as_of_block in the reply against what you asked for.
This is the accurate counterpart of /at, which answers for a whole day.

Authorizations

ApiKeyAuth

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.

Type

API Key (header: X-API-KEY)

Parameters

Header Parameters

X-Real-IP*

An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.

Type

string

Required

Example"203.0.113.10"

Format

"ipv4"

Path Parameters

address*

TRON address in base58, exactly 34 characters.

Type

string

Required

Example"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Min Length

34

Max Length

34

Query Parameters

block

Block height. Mutually exclusive with ts.

Type

integer

Example86012345

Minimum

1

ts

Moment in UTC, YYYY-MM-DD HH:MM:SS. Mutually exclusive with block.

Type

string

Example"2026-09-01 12:00:00"

Responses

Balances at the requested point.

Content-Type

application/json

{

  

"status": "success",

  

"code": 0,

  

"msg": "",

  

"data": {

  

  

"address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

  

  

"as_of_block": 86012345,

  

  

"as_of_time": "2026-09-01 12:00:00 UTC",

  

  

"total_value_usd": "385.25",

  

  

"live": true,

  

  

"hide_spam": true,

  

  

"balances": [

  

  

  

{

  

  

  

  

"token_id": "TRX",

  

  

  

  

"symbol": "TRON",

  

  

  

  

"token_type": "TRX",

  

  

  

  

"decimals": 6,

  

  

  

  

"balance": "1141.899000",

  

  

  

  

"price_usd": "0.334968",

  

  

  

  

"value_usd": "382.50",

  

  

  

  

"is_verified": true,

  

  

  

  

"is_spam": false,

  

  

  

  

"node_balance": "1141.899000"

  

  

  

}

  

  

]

  

}

}

GET

/balances/{address}/at-block

Playground

Authorization

ApiKeyAuth

Headers

X-Real-IP*

Variables

Key

Value

address*

block

ts

Samples

Powered by VitePress OpenAPI