How do I install the Ton Balance skill?

Run npx skillmds@latest add ton-org/ton-balance in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ton Balance safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ton Balance?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ton Balance free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ton Balance?

ton-org (@ton-org) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ton Balance by ton-org — Agent Skill

Name: Ton Balance
Author: ton-org

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.

ton-org Updated Sep 17, 2026

File contents

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

Call get_wallet for address and network info
Call get_balance for GRAM (ex. 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 GRAM (ex. TON)). Use amount for display; use amountRaw only when a raw integer is required.

---name: ton-balancedescription: 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.---# GRAM (ex. TON) Balance & Transaction QueriesRead-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 Balance1. Call `get_wallet` for address and network info2. Call `get_balance` for GRAM (ex. TON) balance3. Call `get_jettons` for all token holdings### Check Specific Token1. If user mentions a token by name, call `get_known_jettons` to find its address2. Call `get_jetton_balance` with the `jettonAddress`### View Transaction History1. Call `get_transactions` with an optional `limit` (default varies)### Verify a Sent Transaction1. 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.

Frequently asked questions