Statement preview for one token

GET

/balances/{address}/statement

Returns the statement of one token for a period straight away: opening and closing balance, totals, a reconciliation check and the first operations. This is a preview meant for display — the number of operations is capped by ops_limit, and operations_total tells you how many there are in full.
For the complete list request a file through POST /reports/statement; it is built in the background and downloaded when ready.

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

token_id

TRX, a TRC20 contract address, or a numeric TRC10 id.

Type

string

Default

"TRX"

date_from*

Start of the period, UTC.

Type

string

Required

Format

"date"

date_to*

End of the period, UTC, inclusive.

Type

string

Required

Format

"date"

ops_limit

How many operations to return in the preview.

Type

integer

Minimum

10

Maximum

5000

Default

500

Responses

Statement preview.

Content-Type

application/json

{

  

"status": "success",

  

"code": 0,

  

"msg": "",

  

"data": {

  

  

"address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

  

  

"token_id": "TRX",

  

  

"period": {

  

  

  

"from": "string",

  

  

  

"to": "string"

  

  

},

  

  

"opening_balance": "string",

  

  

"closing_balance": "string",

  

  

"net_change": "string",

  

  

"totals": {

  

  

  

"in": "string",

  

  

  

"out": "string",

  

  

  

"fee": "string"

  

  

},

  

  

"reconciliation": {

  

  

  

"status": "OK",

  

  

  

"formula": "string"

  

  

},

  

  

"operations_total": 197,

  

  

"operations_truncated": true,

  

  

"operations": [

  

  

  

{

  

  

  

  

"ts": "2026-09-01 00:20:06",

  

  

  

  

"date": "string",

  

  

  

  

"tx": "string",

  

  

  

  

"type": "OUT",

  

  

  

  

"description": "TRX transfer out",

  

  

  

  

"counterparty": "string",

  

  

  

  

"counterparty_name": "string",

  

  

  

  

"in": "0.000000",

  

  

  

  

"out": "1500.000000",

  

  

  

  

"fee": "0.345000",

  

  

  

  

"balance_after": "string",

  

  

  

  

"is_spam": true

  

  

  

}

  

  

]

  

}

}

GET

/balances/{address}/statement

Playground

Authorization

ApiKeyAuth

Headers

X-Real-IP*

Variables

Key

Value

address*

token_id

date_from*

date_to*

ops_limit

Samples

Powered by VitePress OpenAPI