API V2
Direct liteserver for balances, sending transactions, contract queries.
API V3
Indexed database for traces, Jettons, NFTs, and historical queries.
Streaming
Real-time blockchain events over SSE and WebSocket.
Claude Code Plugin
Install the AI plugin to query TON blockchain via Claude Code.
Quick start
Installation
aiohttp 3.9+, pydantic 2.4+.
Networks
| Network | Enum value | Base URL |
|---|---|---|
| Mainnet | Network.MAINNET | https://toncenter.com |
| Testnet | Network.TESTNET | https://testnet.toncenter.com |
API Key
An API key is optional for REST — requests without a key are throttled to ~1 RPS. It is required for streaming (SSE/WebSocket). A key unlocks higher rate limits for production use. Get a key from the @toncenter Telegram bot.| Plan | RPS | Keys / network | Price |
|---|---|---|---|
| Free | 10 | 1 | Free |
| Plus | 25 | 3 | 2.5 TON/mo |
| Advanced | 100 | 10 | 25 TON/mo |
| Enterprise | — | — | Contact support |