The TON API offers a collection of REST, GraphQL, and streaming endpoints together with official SDKs, enabling developers to read and write data on the TON blockchain. It supports real‑time event feeds, account queries, NFT and Jetton operations, and utilities for testing and emulation.
Overview#
TON API aggregates official and community‑contributed development kits for multiple programming languages. These kits simplify building decentralized applications (dApps) on TON by handling low‑level blockchain interactions such as account lookups, transaction submission, and data decoding.
Core components
- REST endpoints for accounts, NFTs, Jettons, DNS, wallets, rates, staking, traces, multisig, blockchain data, schemas, emulation, inscriptions, utilities, and lite‑server access.
- Streaming API using Server‑Sent Events (SSE) to push real‑time updates on new blocks, finalized transactions, traces, and pending messages.
- GraphQL API with an interactive Playground for flexible queries and mutations.
- Official SDKs: Go (
tonapi-go), JavaScript/TypeScript (@ton-api/client), legacy JS/TS (tonapi-sdk-js), and a compatibility layer for extended blockchain capabilities. - Community SDK: Python implementation hosted on GitHub.
Pricing tiers#
TON API is offered under several usage‑based plans:
- Free – 1 request / sec, 1 real‑time connection, up to 5 watched accounts.
- Lite – $9.9 /month, 10 requests / sec, 5 real‑time connections, up to 10 watched accounts, event streaming.
- Standard – $95 /month, 100 requests / sec, 50 real‑time connections, up to 50 watched accounts, event streaming.
- Plus – $290 /month, 300 requests / sec, 1000 real‑time connections, up to 100 watched accounts, event streaming.
- Heavy – $890 /month, 1000 requests / sec, 1000 real‑time connections, up to 1000 watched accounts, event streaming.
Custom enterprise plans with unlimited request rates and connections are also available.
Development workflow#
- Select an SDK that matches your language stack.
- Generate client code from the OpenAPI/Swagger specification if a native SDK is not provided.
- Authenticate (if required) and start issuing API calls to retrieve account data, NFT collections, Jetton balances, or to simulate transactions via the emulation endpoints.
- Subscribe to the Streaming API for live updates when building wallets, explorers, or analytics dashboards.
Related resources#
- TON Connect – authentication protocol for wallet integration.
- TON SDK – low‑level library for building custom clients.
- TON Console – documentation portal hosting the API Playground and cookbook examples.
See also#
- TON Connect
- TON SDK (no existing slug)
- TON Console