ton-balance

TON 余额与交易查询

查询 TON 上的钱包余额、代币持仓和交易历史（只读）。

MCP 工具

工具	必填	可选
get_wallet	—	walletSelector
get_balance	—	walletSelector
get_balance_by_address	address	walletSelector
get_jetton_balance	jettonAddress	walletSelector
get_jettons	—	walletSelector
get_jettons_by_address	address	limit、offset、walletSelector
get_jetton_info	jettonAddress	walletSelector
get_known_jettons	—	—
get_transactions	—	limit、walletSelector
get_transaction_status	normalizedHash	walletSelector

工作流

查看余额

1. 调用 get_wallet 获取地址和网络信息
2. 调用 get_balance 获取 TON 余额
3. 调用 get_jettons 获取所有代币持仓

查看指定代币

1. 如果用户提到代币名称，调用 get_known_jettons 查找其地址
2. 使用 jettonAddress 调用 get_jetton_balance

查看交易历史

1. 调用 get_transactions，可选传入 limit（默认值可能不同）

验证已发送的交易

1. 使用发送／兑换操作返回的 normalizedHash 调用 get_transaction_status

注意事项

• 所有工具均为只读，无需确认
• 在注册表模式下，传入 walletSelector 可查询指定钱包，而非当前活动钱包
• 所有余额响应都包含 amountRaw（原始整数字符串）和 amount（便于阅读的小数字符串，例如，1.5 TON 对应 "1.5"）。显示时使用 amount；仅在需要原始整数时使用 amountRaw。