GetBlockBalance

Query recorded TRX balance changes in a block after verifying that the node has stored balance history for that block.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Prerequisites and missing data

This endpoint reads block balance traces stored by the node. Self-hosted nodes set storage.balance.history.lookup to false by default. After it is enabled, the node records traces only for blocks it processes from that point forward; it does not backfill earlier blocks automatically.

If you do not run your own node, the official historical-balance endpoints are http://13.228.119.63:8090, http://18.139.193.235:8090, http://18.141.79.38:8090, and http://18.139.248.26:8090. Public-node availability and history coverage can change, so verify that the target block is within the recorded range before relying on a response.

If the block exists but the node has no stored balance trace for it, java-tron returns This block does not exist. This message indicates that the local trace is missing and does not by itself prove that the block is absent from the chain. Check the block with GetBlock, then verify that the node's recorded history covers the target height. A missing trace must not be interpreted as “the block had no balance changes.”

Related resources

Body Params
string
required

Block hash (ID). Example: 0000000003dba95c7f05cedf1ba32cd64b6baa082a7870f533b4451703e432ab

int64
required

Block number. The block hash and block number must be consistent, referring to the same block. Example: 64727388

boolean

Optional. Set to true to format addresses in Base58; set to false for hex format. (Default: false)

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json