Home / Guides

Which TON API Fits Your App: TON Center or TonAPI

Updated

A TON API is a hosted HTTP interface to the TON blockchain, so your app can read balances, transactions and jettons without running a node. Two services come up in almost every toncenter vs tonapi question: TON Center, with API v2 and v3, and TonAPI, whose keys come from TON Console. In our checks up to 15 Nov 2026, the lowest 7-day uptime among the three endpoints was 100%, with median responses between 129 ms and 182 ms across at least 32 checks each. Below are their documented limits as of November 2026 and the checks behind those numbers.

In this guide · 10 sections
  1. Key figures from our checks
  2. Toncenter vs TonAPI: what is the difference?
  3. How we measure speed and uptime
  4. Do I need a TON API key?
  5. Wallet, bot or Mini App: which API?
  6. Block lag: why fresh data differs
  7. How to check it yourself
  8. FAQ
  9. Projects in this guide
  10. Sources

Key figures from our checks

The table below compares three TON API endpoints on uptime, response time and block lag, taken from our own recurring checks.

Each row shows how many checks sit behind its percentages, and that count matters. A handful of samples can swing uptime by several points, so read the percentage and the check count together. How the checks work is explained further down, and the full history lives on the Pulse page.

TargetUptime, 7 daysUptime, 30 daysMedian response (p50), 7 daysSlow tail (p95), 7 daysMedian block lag, 7 daysChecks, 7 / 30 daysLast check
TON Center API v2100%98.33%182 ms523 ms4 blocks32 / 60Up
TON Center API v3100%98.33%149 ms512 ms0 blocks32 / 60Up
TonAPI100%100%129 ms511 ms3 blocks32 / 60Up
TON Center API v2Median response (p50) by day
TON Center API v2 median response by day: 177 ms on 2026-11-02, 402 ms on 2026-11-15, low 117 ms, high 402 ms
TON Center API v3Median response (p50) by day
TON Center API v3 median response by day: 175 ms on 2026-11-02, 161 ms on 2026-11-15, low 128 ms, high 235 ms
TonAPIMedian response (p50) by day
TonAPI median response by day: 168 ms on 2026-11-02, 140 ms on 2026-11-15, low 109 ms, high 171 ms

Values refresh whenever the data file does. The three probes call different endpoints, so a gap in response time between rows is a hint, not a ranking.

Data as of · Source: Pulse bot, checks several times a day from a GitHub-hosted runner in the US, check counts in the table · How we measure

Toncenter vs TonAPI: what is the difference?

TON Center is the provider documented on docs.ton.org. TonAPI is a separate REST service with its own keys.

docs.ton.org calls TON Center "the official provider of HTTP APIs for TON" and lists three products: API v2, API v3 and a Streaming API v2. TonAPI describes itself as a SaaS service with REST, streaming, webhooks, GraphQL and liteservers. Its footer still reads "Powered by Tonkeeper"; that wallet is now Keeper (formerly Tonkeeper).

Inside TON Center the split is about indexing. API v2 is the non-indexed layer: it uses tonlib to query liteservers and speaks REST and JSON-RPC. API v3 reads raw node storage, parses it and keeps it in PostgreSQL, so it suits history queries better than v2. On v2, minor version 2.0.x is the older Python build and 2.1.x is the C++ build the docs call newer and recommended.

What each service documents, as of November 2026
ItemTON Center API v2TON Center API v3TonAPI
LayerNon-indexed, relays to liteserversIndexed, data stored in PostgreSQLHosted REST service
InterfacesREST and JSON-RPCREST, grouped by accounts, traces, jettons, NFTs, DNS, staking and moreREST, webhooks, streaming, GraphQL
Documented useBalances, state, get-methods, sending messagesTransaction history, traces, decoded Jetton and NFT data, analyticsAccounts, jettons, NFTs, emulation, gasless
Indexer and archive (per docs.ton.org)No indexer; archive depends on the liteserverIndexer and archiveNot covered by docs.ton.org
Self-hostingOpen source, can be self-hostedOpen source, can be self-hostedLimited open-source version (opentonapi); some data may be missing
Base URL or referencetoncenter.com/api/v2toncenter.com/api/v3Swagger UI at tonapi.io/api-v2
StreamingSeparate Streaming API v2 (SSE and WebSocket, API key)Same Streaming API v2Streaming API marked deprecated in TonAPI docs; Webhooks API for real-time updates

One more difference sits in real-time data, and the sources disagree about it. TON Center documents Streaming API v2 over SSE and WebSocket. TonAPI's own docs mark its Streaming API as deprecated and point to its Webhooks API, while docs.ton.org still lists TonAPI streaming endpoints. Each source says its own thing, so check the page for the endpoint you plan to use.

How we measure speed and uptime

We send one light request to each TON API from a US server several times a day and record status, time and block number.

The runner is a GitHub-hosted machine in the US. A check times out after 10 seconds and counts as slow past 3 seconds. The three probes are a getMasterchainInfo call on API v2, a masterchainInfo call on API v3 and a masterchain-head call on TonAPI. Rate-limited and blocked answers are tracked apart from plain outages in our data file.

Those three calls do different work. v2 relays to a liteserver, v3 reads from its indexer database and TonAPI serves its own REST layer, so one sample is not like for like across them. TON Center states on toncenter.com a 99.98% mainnet availability over 90 days and an 85 ms median response. Its vantage point differs from our single US runner, so the two sets are not comparable. Method details are on the methodology page.

Do I need a TON API key?

You can call both without a key, but a TON API key raises the limit. TON Center allows 1 request per second without one.

A key is free on TON Center. Open the @toncenter bot in Telegram, press Start, choose Manage API Keys, pick a plan (Free is the default) and create the key. Mainnet and testnet get separate keys. On API v3 the key goes in the X-API-Key header or the api_key query parameter, and the docs say never to expose it in client-side code. Prices are quoted in Gram (GRAM, also known as Toncoin).

TON Center plans, as of November 2026 (docs.ton.org)
PlanRequests per secondKeys per networkPriceNotes
No key1nonefreeDefault limit
Free101freeShared liteservers, low-volume testing
Plus2532.5 GRAM per monthPrivate liteservers
Advanced1001025 GRAM per monthPrivate infrastructure
Enterprisecustomcustomcontact @toncenter_supportCustom throughput and support

Limits count all keys of one account together, separately for mainnet and testnet, so three Plus keys on mainnet share 25 requests per second. Above the limit, TON Center answers HTTP 429 with the body {"ok": false, "result": "Ratelimit exceed", "code": 429}. The docs advise stopping, waiting a few seconds and retrying with exponential backoff.

TonAPI keys are issued at tonconsole.com and sent as an Authorization: Bearer header. For access without a key, the docs disagree with each other. The TonAPI intro gives 1 request per 4 seconds, while the free limits page gives a default of 1 request per second. We do not pick one. Limits are the same for all tokens on a plan and for testnet and mainnet. TonAPI also lists a separate price list for Liteservers on tonapi.io.

TonAPI plans, as listed on tonapi.io in November 2026 (prices are shown without a billing period)
PlanRequests per secondPrice listed
Start1Free
Lite10$9.9
Standart100$95
Plus300$290
Heavy1,000$890
Customunlimitedcontact support

Wallet, bot or Mini App: which API?

Any TON API can serve a wallet, a bot or a Mini App. The choice comes down to which data your app reads most often.

Choosing a TON API starts with the call you make most. TON Center documents v2 for balances, state and sending messages, and v3 for history and decoded tokens. TonAPI lists accounts, jettons, NFTs, emulation and gasless transfers on its homepage, with keys managed in TON Console. Hosted node access is a separate product, for example dTON with private liteservers.

  • Wallet: balances and sending are v2 territory in the docs; emulation, which TON Center and TonAPI both list, lets you preview a transaction before it goes out.
  • Bot: in our reading of the docs, a bot that reacts to events needs a push channel. TON Center has Streaming API v2, TonAPI has Webhooks.
  • Mini App: the page runs in a user's browser, so a key placed there is visible. TON Center's docs say to keep keys out of client-side code. TonAPI documents a route through the Keeper browser or extension with higher limits, which still needs a valid key. Telegram's own docs are on the Mini Apps card.

Block lag: why fresh data differs

Block lag is how many masterchain blocks an API sits behind the freshest of the three in the same check.

Every API reads the newest block from a different path: v2 asks a liteserver through tonlib, v3 serves what its indexer has already parsed and stored, and TonAPI answers from its own service. Each extra step between node and response is a place where the newest block may not have arrived yet. See the glossary for Indexer and Liteserver.

We have not measured which step adds the delay, so we do not claim a cause. The Key figures table above lists each API's median lag against the freshest API over the window. A gap of a few blocks can come from requests landing at slightly different moments, so a single check cannot rank services. If your app compares block numbers or waits for a transaction to appear, a retry is safer than trusting one read.

How to check it yourself

You can repeat our probes with curl in a minute and compare the time and block number each API returns.

Use the same three TON API endpoints we do. Without keys you are inside the no-key limits above, so a few seconds between calls are needed: TON Center answers HTTP 429 if you go faster. Your location changes response time, so your numbers will not match ours, and that is the point of running them. More tools around these services are in the developer tools category of our directory of TON projects.

  1. Time TON Center v2:
    curl -s -o /dev/null -w "%{time_total}\n" https://toncenter.com/api/v2/getMasterchainInfo
  2. Time TON Center v3 the same way against https://toncenter.com/api/v3/masterchainInfo
  3. Time TonAPI against https://tonapi.io/v2/blockchain/masterchain-head
  4. Drop the timing flags and read the block number in each JSON answer. Run the three calls a few seconds apart, then repeat later in the day.
  5. Compare your times and block-number gaps with the table above, and open our raw Pulse data if you want the individual checks.

FAQ

Is TON Center free?

Yes, within limits: 1 request per second without a key, 10 with a free key, per docs.ton.org.

What is TON Center API v3?

The indexed layer: it stores parsed node data in PostgreSQL and serves history, traces and decoded Jetton and NFT data.

Does TonAPI need an API key?

Not strictly. Without one, its docs give two limits: 1 request per 4 seconds, and elsewhere 1 per second.

How often do you check?

Several times a day from a US server. Each row in our table shows the number of checks behind it.

What does a 429 error mean here?

You went over your limit. TON Center advises stopping, waiting a few seconds and retrying with exponential backoff.

Projects in this guide

Every project named in this guide has its own page with a short description, live data where we collect it and a link to its official site.

  • TON Center

    HTTP APIs for TON, from direct liteserver access to an indexer

    • Web
  • TONAPI

    REST API, webhooks and streaming for TON apps

    • Web
  • TON Console

    A dashboard for managing dApps, tokens and API access

    • Web
  • dTON

    Private liteservers with live status and request analytics

    • Web
  • Telegram Mini Apps

    The official Telegram documentation for building Mini Apps

    • Telegram
    • Web

Sources