GetBlockBalance

查询指定区块中已记录的 TRX 余额变动;使用前需确认节点已启用并积累历史余额记录。

使用前提与缺数据处理

该接口读取节点本地保存的区块余额轨迹。自建节点默认将 storage.balance.history.lookup 设为 false;启用后,节点只为随后处理的区块保存轨迹,不会自动回填此前的区块。

如不自建节点,可使用官方历史余额节点 http://13.228.119.63:8090、http://18.139.193.235:8090、http://18.141.79.38:8090 或 http://18.139.248.26:8090。公共节点的可用性和历史覆盖范围可能变化,调用前仍需验证目标区块是否在其记录范围内。

当请求的区块本身存在、但节点没有保存对应的余额轨迹时,java-tron 会返回 This block does not exist。这条错误只说明本地轨迹缺失,不能单独证明链上区块不存在。业务系统应先用 GetBlock 核对区块,再确认所用节点的历史记录覆盖范围;用于对账时,不应把缺轨迹响应当作“该区块没有余额变动”。

相关资源

  • GetAccountBalance —— 按账户而非按区块查询余额变动
  • GetBlock —— 查询区块完整内容(含交易)
  • 区块 —— 区块结构与复合区块 ID
Body Params
string
required

区块哈希(ID)。示例:0000000003dba95c7f05cedf1ba32cd64b6baa082a7870f533b4451703e432ab

int64
required

区块编号。区块哈希与区块编号必须一致,指向同一区块。示例:64727388

boolean

可选。设置为 true 时地址以 Base58 格式返回;设置为 false 时以 hex 格式返回。(默认:false)

Responses

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