post
https://api.shasta.trongrid.io/wallet/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
