ton-balance

Original：🇺🇸 English

Translated

Use this skill when checking TON wallet balances, token holdings, or transaction history. It retrieves how much TON or jettons a wallet holds, lists tokens, looks up token details, checks transaction history, and verifies transaction status. Also use when the user asks about their funds, portfolio, or recent activity on TON.

3installs

Sourceton-org/skills

Added on2026-05-11

NPX Install

npx skill4agent add ton-org/skills 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.