ton-balance

Original：🇺🇸 English

Translated

Check TON wallet balances, token holdings, and transaction history. Use when the user wants to check their balance, see how much TON they have, list tokens, view jettons, check transaction history, look up a token, or verify a transaction status.

2installs

Sourceton-connect/kit

Added on2026-03-26

NPX Install

npx skill4agent add ton-connect/kit ton-balance

SKILL.md Content

View Translation Comparison →

TON Balance & Transaction Queries

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

MCP Tools

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`

Workflows

Check Balance

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

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
```

View Transaction History

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

Verify a Sent Transaction

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

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.