post
https://api.shasta.trongrid.io/wallet/getaccountbalance
查询指定区块高度的账户 TRX 余额；使用前需确认节点已启用并积累历史余额记录。
使用前提与缺数据处理
该接口读取节点本地保存的历史余额轨迹，不会根据历史区块即时重建余额。自建节点默认关闭此功能；如需使用，应在处理目标区块前将 storage.balance.history.lookup 设为 true。节点只记录启用后处理的余额变化，之后再开启不会自动补齐此前的历史数据。
如不自建节点，可使用官方历史余额节点 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 可能仍返回 HTTP 200，并将 balance 返回为 0。该结果无法区分“余额确实为 0”和“节点没有记录”。用于充值、对账或审计时，应先确认所用节点的历史记录覆盖目标区块，并使用已知账户或检查点验证数据；不要把未经验证的数据源返回的 0 直接视为真实余额。
相关资源
- GetAccount —— 查询账户当前完整状态（含所有余额维度）
- 账户 —— 账户模型
- 区块 —— 按区块查询余额（使用区块 ID）