/tonapi

Work with TON blockchain via the tonapi Python SDK — query accounts, transactions, jettons, NFTs, staking, DNS, emulate messages, subscribe to real-time events, and manage webhooks. Use this skill whenever the user mentions TONAPI, tonapi.io, TON blockchain data, wallet balance,

nessshon@nessshon

GitHub

From plugin

tonapi

1871 skill

Install

$ npx -y skills add nessshon/tonapi --skill tonapi --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/tonapi

Context preview

The summary Claude sees to decide when to auto-load this skill.

Work with TON blockchain via the tonapi Python SDK — query accounts, transactions, jettons, NFTs, staking, DNS, emulate messages, subscribe to real-time events, and manage webhooks. Use this skill whenever the user mentions TONAPI, tonapi.io, TON blockchain data, wallet balance,

SKILL.md

tonapi.SKILL.md

name: tonapi
description: >
  Work with TON blockchain via the tonapi Python SDK — query accounts,
  transactions, jettons, NFTs, staking, DNS, emulate messages, subscribe to
  real-time events, and manage webhooks. Use this skill whenever the user
  mentions TONAPI, tonapi.io, TON blockchain data, wallet balance, jetton
  transfers, NFT collections, or wants to interact with TON via TONAPI.
  Also use when the user works with code that imports from pytonapi.rest,
  pytonapi.streaming, pytonapi.webhook, or pytonapi.types, or asks about
  TONAPI endpoints, even if they don't explicitly mention "pytonapi".

Python SDK for querying TON blockchain via TONAPI. Covers REST API, streaming (SSE/WebSocket), and webhooks with event dispatcher. Read the relevant reference file, then either execute via runner or generate SDK code.

API Key

Optional — without a key, REST requests are throttled to ~1 per 4 seconds. A key unlocks higher rate limits for production use. Get one at [tonconsole.com](https://tonconsole.com/).

Networks

| Network | Enum | Base URL | |---------|-------------------|-----------------------------| | Mainnet | `Network.MAINNET` | `https://tonapi.io` | | Testnet | `Network.TESTNET` | `https://testnet.tonapi.io` | | Tetra | `Network.TETRA` | `https://tetra.tonapi.io` |

Routing Table

| User intent | Reference | Runner example | |------------------------------------------------|--------------------------------|-----------------------------------------------------| | Installation, setup, first request | `references/quickstart.md` | — | | SDK version | — | `pytonapi -v` | | Account info, balance, jetton balances, events | `references/accounts.md` | `accounts get_account --account-id EQ...` | | Blocks, transactions, validators, config | `references/blockchain.md` | `blockchain get_masterchain_head` | | TonConnect payload, state init | `references/connect.md` | `connect get_ton_connect_payload` | | DNS domains, auctions, bids | `references/dns.md` | `dns get_info --domain-name ton` | | Message decoding, emulation | `references/emulation.md` | `emulation decode_message --body {...}` | | Events by ID | `references/events.md` | `events get_event --event-id ...` | | Extra currency info | `references/extra_currency.md` | `extra_currency get_info --id 1` | | Gasless transfers | `references/gasless.md` | `gasless config` | | Jetton info, holders, transfers | `references/jettons.md` | `jettons get_jetton_info --account-id EQ...` | | Raw liteserver operations | `references/lite_server.md` | `lite_server get_raw_masterchain_info` | | Multisig wallets, orders | `references/multisig.md` | `multisig get_account --account-id EQ...` | | NFT collections, items, history | `references/nft.md` | `nft get_collection --account-id EQ...` | | Purchase history | `references/purchases.md` | `purchases get_purchase_history --account-id EQ...` | | Token prices, charts, markets | `references/rates.md` | `rates get_rates --tokens ton --currencies usd` | | Staking pools, nominators | `references/staking.md` | `staking get_pools` | | TON storage providers | `references/storage.md` | `storage get_providers` | | Execution traces | `references/traces.md` | `traces get_trace --trace-id ...` | | API status, address parsing | `references/utilities.md` | `utilities status` | | Wallet info, seqno, auth | `references/wallet.md` | `wallet get_info --account-id EQ...` | | Real-time events (SSE/WebSocket) | `references/streaming.md` | `streaming sse --types transactions` | | Webhooks (push notifications) | `references/webhooks.md` | — (generate code) |

Runner

Always run the runner from the **user's working directory**, not from the skill directory. Use `${CLAUDE_SKILL_DIR}` to reference the script path:

python3 ${CLAUDE_SKILL_DIR}/scripts/run.py <resource> <method> [--param value ...]
python3 ${CLAUDE_SKILL_DIR}/scripts/run.py streaming <transport> [--types type ...]

Requires `pytonapi` package installed (`pip install pytonapi`).

Configuration priority: CLI flags > environment variables > defaults.

| Source | API Key | Network | Base URL | RPS Limit | RPS Period | |---------|------------------|-------------------------------------|-------------------|--------------------|---------------------| | CLI | `--api-key KEY` | `--network mainnet\|testnet\|tetra` | `--base-url URL` | `--rps-limit N` | `--rps-period N` | | Env | `TONAPI_API_KEY` | `TONAPI_NETWORK` | `TONAPI_BASE_URL` | `TONAPI_RPS_LIMIT` | `TONAPI_RPS_PERIOD` | | Default | — (optional) | `mainnet` | auto by network | `0` (disabled) | `1.0` |