Query TON blockchain data through the REST API. The SDK exposes two API versions via a single client — V2 for direct liteserver access and V3 for indexed data.Documentation Index
Fetch the complete documentation index at: https://toncenter.ness.su/llms.txt
Use this file to discover all available pages before exploring further.
API key is optional — without a key, requests are throttled to ~1 RPS. Get a key from the @toncenter bot.
Quick Example
Networks
| Network | Enum value | Base URL |
|---|---|---|
| Mainnet | Network.MAINNET | https://toncenter.com |
| Testnet | Network.TESTNET | https://testnet.toncenter.com |
V2 or V3
They query the same blockchain but serve different purposes.| API V2 | API V3 | |
|---|---|---|
| Backend | Direct liteserver queries via tonlib | Indexed PostgreSQL database |
| Latency | Real-time (latest block) | Near real-time (indexer delay) |
| Best for | Current state, sending transactions, get-methods | Historical data, search, filters, pagination |
| Pagination | No (fixed result sets) | Yes (limit, offset, sort) |
| Jettons/NFTs | Single item via get-method | Full query API with filters |
| Traces/Actions | Not available | Full trace trees and parsed actions |
| Metadata | Not available | Token metadata, address book, DNS records |