A zero-config tool for querying TON blockchain wallet balances, statuses, and transaction activity via the TonScan API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tonscan-address-balance
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tonscan-address-balance using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TonScan Wallet Balance?
The TonScan Wallet Balance skill allows your AI agent to fetch real-time data from the TON blockchain without requiring an API key. It interfaces directly with the TonScan public API to retrieve account details, including current balances, initialization status, and last activity timestamps. This skill is a vital addition to Openclaw Skills for developers building financial assistants or blockchain monitoring tools.
By handling the conversion from nanotons to TON automatically, it ensures that data is presented in a human-readable format. Whether you are dealing with user-friendly EQ addresses or raw hex formats, this skill provides a robust bridge between the blockchain and your AI workflows.
TonScan Wallet Balance Use Cases
- Checking the balance of a specific TON wallet address.
- Verifying if a TON account is active, uninitialized, or frozen.
- Monitoring recent activity on-chain for specific addresses.
- Converting raw nanoton values into display-ready TON units.
- Integrating blockchain data lookups into automated reporting workflows using Openclaw Skills.
How TonScan Wallet Balance Works
- The AI agent receives a TON wallet address from the user.
- The skill validates the address format, supporting both user-friendly (EQ/UQ) and raw hex formats.
- A GET request is dispatched to the TonScan API endpoint without requiring authentication.
- The skill parses the JSON response, specifically extracting the nested data under the detail object.
- Raw nanoton values are converted to standard TON units by dividing by 1,000,000,000.
- The formatted balance and account status are returned as a structured summary.
TonScan Wallet Balance Setup
No API key is required to use this skill, making it one of the most accessible Openclaw Skills available. You can test the connectivity using a simple bash command:
curl -s "https://api.tonscan.com/api/bt/getAddressInformation?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
For local development, ensure your environment can handle large integers, as TON balances can exceed standard precision limits.
TonScan Wallet Balance Data Schema & Taxonomy
The skill retrieves data organized into a clear hierarchy. The following table describes the primary data points returned:
| Field | JSON Path | Description |
|---|---|---|
| Raw Balance | .json.data.detail.balance |
Balance represented in nanotons (integer string) |
| Canonical Address | .json.data.detail.address |
The official string representation of the wallet |
| Account Status | .json.data.detail.status |
State of the wallet: active, uninitialized, or frozen |
| Last Activity | .json.data.detail.last_activity |
Unix timestamp of the most recent transaction |
TonScan Wallet Balance Advanced Features
- Multi-format Address Support: Seamlessly handles both User-friendly and Raw TON address formats.
- High-Precision Handling: Recommendations for using BigInt to prevent rounding errors in financial applications.
- Status Awareness: Distinguishes between zero-balance active accounts and uninitialized addresses.
- Rate Limit Resilience: Structured for easy integration of exponential backoff for high-volume Openclaw Skills implementations.
- Zero-Key Integration: Allows for immediate deployment in sandbox or production environments without credential management.
SKILL.md
Loading
Related Openclaw Skills
Token Saver 75+
An intelligent orchestration protocol that automates model routing and output compression to achieve massive token savings.
Luma Event Manager
An automated event management tool for Luma that enables discovery, RSVPs, and calendar synchronization via intelligent web scraping.
gitclaw
An automated backup tool that mirrors your OpenClaw workspace to a GitHub repository using a cron-driven sync script.
eToro Trading & Market Data
Enables AI agents to perform automated trading, portfolio management, and social sentiment analysis via the eToro Public API.
Bandwidth Income
Automate the deployment and management of bandwidth-sharing nodes to generate passive crypto income from your idle internet connection.
Bandwidth Income
Turn your idle internet bandwidth into passive cryptocurrency earnings through automated node management and monitoring.
Featured*
