Skip to main content
To ensure stability and fair access, TON Center applies rate limits to all API requests.
If your application exceeds these limits, the API returns a 429 response. You can increase your limits by requesting an API key and selecting a higher subscription plan. Without any API key, the default rate limit is 1 request per second.

​
Default limits

PlanTokens per NetworkRequests per SecondNotes
Free110Shared liteservers, ideal for quick tests and small projects.
Plus325Private liteservers for more consistent performance.
Advanced10100Private infrastructure with priority routing.
EnterpriseCustomCustomTailored throughput and support. Contact @toncenter_support for details.
Rate limits apply per API token and per network (mainnet/testnet).
Each token represents an individual API key used to authenticate requests.
Plans differ by how many tokens you can generate per network (mainnet and testnet).
For example, the “Free” plan allows 1 key per network, while higher plans provide multiple keys for separate apps or environments.

​
Rate limit exceeded

When requests are sent faster than the allowed rate limit, the TON Center API temporarily blocks new ones.
You’ll receive a JSON response that tells you the rate limit was exceeded: 
{
  "ok": false,
  "result": "Ratelimit exceed",
  "code": 429
}
When this occurs:
  • Stop sending new requests and wait a few seconds before retrying.
  • Implement exponential backoff to avoid repeated rate-limit violations.

​
Common mistakes

If you purchased a paid plan but still experience a 1 RPS rate limit:
  • Check that your API key is included correctly in your requests.
    Requests without a valid API key are limited to 1 RPS, even if a subscription is active.
  • Verify the correct key is used for the intended environment (mainnet or testnet).
    Each network requires its own key.
  • Wait up to 10 minutes after upgrading your plan or changing your API key.
    Subscription and key updates can take several minutes to propagate across TON Center’s rate-limiting system.