# Ton Balance

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

- Skill: `ton-org/ton-balance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ton-org/ton-balance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ton-org/ton-balance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Coding & Dev Tools
- Author: ton-org (https://skillmd.com/u/ton-org)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ton-org/ton-balance

---


# GRAM (ex. 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 GRAM (ex. 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 GRAM (ex. TON)). Use `amount` for display; use `amountRaw` only when a raw integer is required.