Logo

TON Testnet RPC Endpoints & API

The Open Network for everyone

Build and validate on TON Testnet using RPC endpoints for testing, staging, integrations, and release checks before production.

The Open Network for everyone

TON Testnet RPC Endpoint

The below example uses the public API endpoint*. This endpoint is only suitable for testing. To avoid rate limiting and service interruption, sign up now to get your own API key.
Example CURL
curl -H 'content-type:application/json' -d '{"id": 1, "jsonrpc": "2.0", "method": "getMasterchainInfo"}' 'https://ton-testnet.api.onfinality.io/public'
curl -H 'content-type:application/json' -d '{"id": 1, "jsonrpc": "2.0", "method": "getMasterchainInfo"}' 'https://ton-testnet.api.onfinality.io/public'
HTTPs
https://ton-testnet.api.onfinality.io/public
https://ton-testnet.api.onfinality.io/public
Websocket
wss://ton-testnet.api.onfinality.io/public-ws
wss://ton-testnet.api.onfinality.io/public-ws

* The public endpoint is rate limited

RPC API Service

RPC API Features

FullArchive

RPC Regions

N.VirginiaHong Kong

PRICING

Calculate Your Costs

Only pay for what you need.

Million Standard Requests
0100M200M300M400M
Total Cost
$49/ month

Recommended Plan: GROWTH

Continue with this plan

TON Testnet RPC Endpoint & API Service

Build and test your TON applications with confidence using OnFinality's managed TON Testnet RPC endpoints. Whether you are developing smart contracts, integrating wallets, or preparing for mainnet deployment, our reliable testnet infrastructure gives you the stable access you need without running your own node.

What is TON Testnet?

TON Testnet is a sandbox environment for The Open Network (TON) — a decentralized and open internet designed to onboard 500 million users on-chain, built by the community using technology developed by Telegram. The testnet allows developers to experiment, debug, and validate their applications in a risk-free setting before moving to mainnet.

Why Use OnFinality for TON Testnet RPC?

  • Managed Infrastructure: No need to sync or maintain your own TON node. OnFinality handles uptime, updates, and scaling.
  • Archive Data: Access historical state for deep debugging and analytics.
  • Global Regions: Endpoints available in N. Virginia and Hong Kong for low-latency connections.
  • Observability: Monitor request usage, errors, and limits through the OnFinality dashboard.
  • Scaling Path: Start with shared RPC and upgrade to dedicated nodes as your project grows.

How to Connect to TON Testnet

  1. Create or sign in to your OnFinality account.
  2. Select TON Testnet from the supported networks list.
  3. Create an API endpoint (shared or dedicated if available).
  4. Test your connection using the getMasterchainInfo method.
  5. Monitor your usage and move to production traffic when ready.

Key Facts

  • Network: TON Testnet
  • Protocol: TON JSON-RPC
  • Transport: HTTP and WebSocket
  • Advanced Access: Archive
  • Common Use Cases: Contract testing, QA, staging releases, wallet integration testing, backend validation

TON Testnet RPC vs Public RPC

Public TON Testnet RPC endpoints are convenient for quick experiments but often lack reliability and visibility for team projects. OnFinality provides authenticated endpoints with clearer limits, request analytics, and a path to higher capacity.

TON Testnet RPC resources

Teams usually use TON Testnet to test app behaviour, wallet flows, and backend requests before a production release, not to make a long-term infrastructure decision on day one.

Best fit: testnet testing workflows for developer testing, integrations, and rollout prep.

What builders usually check first:

  • Run contract, wallet, and backend checks before sending users to mainnet.
  • Keep QA and staging environments close to the production chain model.
  • Validate reads, writes, and event handling with low-risk test traffic.
  • Move from shared testnet access to mainnet or dedicated infrastructure when release traffic becomes predictable.

Supported capability notes:

  • Authenticated TON Testnet RPC/API access for developer testing, integrations, and rollout prep.
  • Flexible HTTP and WebSocket access for app, backend, and integration workflows.
  • Archive-capable workflows when the product needs older chain state.
  • A lower-risk place to validate contracts, wallets, and backend behaviour.

Decision notes:

  • Environment: testnet. Protocol family: TON JSON-RPC.
  • Flexible HTTP and WebSocket access is listed for supported app and backend workflows.
  • Archive support is available for historical state or older chain-data queries.
  • Available regions listed by the network spec include N.Virginia, Hong Kong.

A quick connection check usually starts with getMasterchainInfo, then moves into the exact methods your wallet, dashboard, bot, indexer, or backend service needs.

Planning the next step:

  • Use this network for integration confidence first: contract calls, wallet flows, event handling, and backend jobs.
  • Before launch, repeat the same checks against the target mainnet and review pricing or dedicated-node needs.

Next steps:

RPC API SERVICE
Reliable RPC endpoints with high rate limits
Powerful RPC request analytics
99.99% uptime
Connect via HTTPS or websocket
Decentralised servers hosted globally
Full archive access at no extra cost

Never Worry about Infrastructure Again

OnFinality takes away the heavy lifting of DevOps so you can build smarter and faster.

Get Started