Back to Details

ton-balance

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TON Balance & Transaction Queries

TON余额与交易查询

Read-only queries for wallet balances, token holdings, and transaction history on TON.

用于查询TON网络上钱包余额、代币持有情况及交易历史的只读查询工具。

MCP Tools

MCP工具

Tool	Required	Optional
`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`

工具	必填参数	可选参数
`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`

Workflows

工作流

Check Balance

查看余额

Call
```
get_wallet
```
for address and network info
Call
```
get_balance
```
for TON balance
Call
```
get_jettons
```
for all token holdings

调用
```
get_wallet
```
获取地址和网络信息
调用
```
get_balance
```
获取TON余额
调用
```
get_jettons
```
获取所有代币持有情况

Check Specific Token

查询特定代币

If user mentions a token by name, call
```
get_known_jettons
```
to find its address
Call
```
get_jetton_balance
```
with the
```
jettonAddress
```

如果用户提及代币名称，调用
```
get_known_jettons
```
查找其地址
使用
```
jettonAddress
```
调用
```
get_jetton_balance
```

View Transaction History

查看交易历史

Call
```
get_transactions
```
with an optional
```
limit
```
(default varies)

调用
```
get_transactions
```
，可选择传入
```
limit
```
参数（默认值有所不同）

Verify a Sent Transaction

验证已发送交易

Call
```
get_transaction_status
```
with the
```
normalizedHash
```
returned by a send/swap operation

使用发送/兑换操作返回的
```
normalizedHash
```
调用
```
get_transaction_status
```

Notes

注意事项

All tools are read-only — no confirmation needed
In registry mode, pass
```
walletSelector
```
to query a specific wallet instead of the active one
All balance responses include both
```
amountRaw
```
(raw integer string) and
```
amount
```
(human-readable decimal string, e.g.
```
"1.5"
```
for 1.5 TON). Use
```
amount
```
for display; use
```
amountRaw
```
only when a raw integer is required.

所有工具均为只读模式——无需确认
在注册模式下，传入
```
walletSelector
```
可查询特定钱包，而非当前活跃钱包
所有余额响应均包含
```
amountRaw
```
（原始整数字符串）和
```
amount
```
（人类可读的十进制字符串，例如1.5 TON显示为
```
"1.5"
```
）。显示时使用
```
amount
```
；仅当需要原始整数时使用
```
amountRaw
```
。