Skip to content

Balances at the end of a date

GET
/balances/{address}/at

Returns the balances as they stood at the end of the requested date in UTC, inclusive. A request for 2026-09-01 answers with the state at 2026-09-01 23:59:59Z, not at midnight.
Unlike the current-balances endpoint, this one carries no freshness caveat: the point being described was passed long ago, so the answer is exact.
Use /at-block when you need a precise moment: on TRON a block appears roughly every three seconds, so a whole day is a coarse cut.

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

on*

Date in UTC, YYYY-MM-DD.

Type
string
Required
Example"2026-09-01"
Format
"date"
token_id

Limit the reply to one token. Omit for all tokens.

Type
string

Responses

Balances at the end of the date.

application/json
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"
  
  
  
}
  
  
]
  
}
}

Playground

Authorization
Headers
Variables
Key
Value

Samples

Powered by VitePress OpenAPI