Period turnover per token
GET
/balances/{address}/summary
Returns, for every token the address touched in the period, the opening balance, everything received, everything sent, fees paid and the closing balance. Useful for reconciliation: opening plus inflow minus outflow minus fees equals closing.
There is no cap on the length of the period beyond date_to not preceding date_from.
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
Requiredstring
Example
"203.0.113.10"Format
"ipv4"Path Parameters
address*
TRON address in base58, exactly 34 characters.
Type
Requiredstring
Example
"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"Min Length
34Max Length
34Query Parameters
date_from*
Start of the period, UTC.
Type
Requiredstring
Example
"2026-09-01"Format
"date"date_to*
End of the period, UTC, inclusive.
Type
Requiredstring
Example
"2026-09-30"Format
"date"Responses
Turnover per token.
application/json
JSON "status": "success", "code": 0, "msg": "", "data": { "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "period": { "from": "string", "to": "string" }, "tokens": [ { "token_id": "TRX", "symbol": "TRON", "token_type": "string", "opening_balance": "76493.940406", "period_in": "141490.950160", "period_out": "216763.731366", "period_fees": "79.260200", "closing_balance": "1141.899000", "value_usd": "382.50" } ] }
{
}