tonapi

📦 TON API

Python SDK for TON API

Access TON blockchain data via REST API, real-time streaming, and webhooks.
API key optional for REST, required for streaming and webhooks — obtain at tonconsole.com.

For creating wallets, transferring TON, jettons, etc., use tonutils.

Features

• REST API — accounts, NFTs, jettons, DNS, and more
• Streaming — real-time events via SSE and WebSocket
• Webhooks — push notifications with event dispatcher

Support this project — TON: donate.ness.ton
UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness

Installation

pip install pytonapi

Claude Code plugin:

/plugin marketplace add nessshon/claude-plugins
/plugin install tonapi@nessshon-plugins

Documentation

Documentation — API reference, streaming, and webhooks guides.
llms.txt — auto-generated machine-readable docs for AI tools.

Examples

REST API

• Get account info
• Get account transactions
• Get jetton info
• Get NFTs by owner
• Get NFTs by collection

Emulation & Sending

• Send message
• Emulate message

Transfers (requires tonutils)

• Transfer TON
• Gasless transfer

Streaming (SSE & WebSocket)

• SSE subscriptions
• WebSocket subscriptions

Webhooks

• FastAPI webhook server
• aiohttp webhook server

License

This repository is distributed under the MIT License.