# Ton Balance

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

- Skill: `ton-org/ton-balance-2` (Agent Skill)
- Install (CLI): `npx get-skill add ton-org/ton-balance-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ton-org/ton-balance-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ton-org (https://skillmd.com/u/ton-org)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ton-org/ton-balance-2

---


# 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
1. Call `get_wallet` for address and network info
2. Call `get_balance` for TON balance
3. Call `get_jettons` for all token holdings

### Check Specific Token
1. If user mentions a token by name, call `get_known_jettons` to find its address
2. Call `get_jetton_balance` with the `jettonAddress`

### View Transaction History
1. Call `get_transactions` with an optional `limit` (default varies)

### Verify a Sent Transaction
1. 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.

