Chainstack GEN 2.0 is live: lower latency for Solana, Ethereum, Base, and every chain on Global Nodes. See what’s new
  • Agentes
  • Precios

TON RPC endpoints for Telegram Mini Apps

Read balances, track Jetton transfers, and power Telegram Mini Apps with reliable, high-performance TON RPC infrastructure.

TON
https://ton-mainnet.core.chainstack.com/YOUR_ENDPOINT_ID
Crear endpoint
Logotipo de Stars para el widget de la página de inicio
get mcp.chainstack.com, deploy TON mainnet RPC node and give me the HTTPS endpoint
ThorFiShrapnelRFOXOdosTradingViewRippleCirclePendleTrust WalletBinanceGoldskyCertiKBlockpourNumioBanditNexoCoinGeckoUniDexVaiVLaunchWorkinmanZapperBitgetTrust WalletAoriPlataKaikoQuantstamp

Fast TON RPC, right where you need it

Global Node

Geo-balanced RPCBuilt for Mini Apps

Connect to TON mainnet or testnet through one geo-balanced endpoint. Access API v2, v3, and v4 for account reads, indexed token data, and block streams without running your own node.

Ilustración de una red global de blockchain node

Your full development stack for TON

Read live account state, query indexed Jetton data, stream blocks, and scale TON workloads with one development stack.

Build and scale with reliable TON RPC

Página de inicio: logotipo «Infra Icon 1»

Build Telegram Mini Apps

Connect wallet-enabled Mini Apps to TON account data and transaction status. Pair TON Connect for user signatures with Chainstack RPC for backend reads and payment tracking.

Explore TON tooling
Logotipo «Infra Icon 2» de la página de inicio

Track USDT and Jetton payments

Query indexed Jetton transfers, verify token master addresses, and reconcile deposits and payouts. Follow message outcomes before marking a payment as settled.

Explore Jetton transfers
Página de inicio: logotipo «Infra Icon 3»

Power wallets and portfolios

Read native balances and Jetton holdings, retrieve transaction history, and submit signed messages. Build account views with TON-native SDKs and indexed APIs.

Explore TON APIs
Logotipo «Infra Icon 4» de la página de inicio

Build TON DeFi applications

Run smart contract get-methods, read pool state, and follow indexed transaction traces. Use node reads or processed data to match your application’s freshness requirements.

Choose a TON API
Página de inicio: logotipo «Infra Icon 5»

Index NFTs and digital assets

Retrieve NFT collections, items, transfers, and metadata through API v3. Connect asset ownership and transaction history to marketplaces and consumer applications.

Get a TON RPC endpoint
10B+Daily API calls across Chainstack
10+Chainstack data centers worldwide
Acceso al servicio de asistencia 24 horas al día, 7 días a la semana
99,99 % o más de tiempo de actividad
Para equipos clasificados

¿Gastas más de 1000 dólares al mes en infraestructura de RPC?

Save over 50% on our elite pay as you go plan

TelegramChatea en Telegram (opens in a new tab)

¿Por qué Dev Chainstack?

Feedback from teams building wallets, security tools, analytics, and trading applications with Chainstack across supported networks.

Fast TON RPC with predictable costs

Power wallets and Telegram Mini Apps with geo-balanced TON APIs. Choose flat-fee Unlimited Node capacity for sustained workloads, or Dedicated Nodes with direct ADNL access for native network integrations.

Get a TON endpoint

TON faucet: free testnet tokens

Fund your wallet. Build on TON.

Get free testnet tokens from the Chainstack TON faucet. Test wallet flows, deploy contracts, and exercise Jetton transfers before moving to TON mainnet.

Top up an eligible wallet to 1 testnet GRAM, with a claim available every 24 hours. Test tokens have no monetary value and cannot pay mainnet fees.

Get testnet tokens (opens in a new tab)
Chainstack testnet faucet illustration

Connect to TON RPC

Read a wallet’s native balance with getAddressBalance through TON API v2.

HTTPS · TON API v2 JSON-RPC
https://ton-mainnet.core.chainstack.com/YOUR_ENDPOINT_ID/api/v2/jsonRPC
WebSocket · TON API v4 blocks
wss://ton-mainnet.core.chainstack.com/YOUR_ENDPOINT_ID/api/v4/block/watch

Create a TON node and copy your endpoint from Access and credentials. Replace YOUR_ENDPOINT_ID with your endpoint ID. The request uses the documented /api/v2/jsonRPC route.

TON Mainnet
curl --request POST \
  --url https://ton-mainnet.core.chainstack.com/YOUR_ENDPOINT_ID/api/v2/jsonRPC \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAddressBalance",
  "params": {
    "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
  }
}'

El result is a balance string in nanotons. This is a read-only request; it does not send a transaction.

View method reference (opens in a new tab)

TON RPC pricing

Start with free TON RPC for mainnet or testnet. Scale wallets and Mini Apps with higher throughput, flat-fee capacity, and dedicated infrastructure.

Planes económicos para todo tipo de cargas de trabajo

Starting from$40/moon annual
Explore paid plans (opens in a new tab)
From 20M requests included monthlyComparar y convertir (opens in a new tab)
  • Higher throughput and larger node allowances

All Developer features, plus:

  • More monthly request units Growth+
  • Add-ons Growth+
  • Dedicated Nodes Pro+
  • Single sign-on Pro+
  • Role-based access Business+
  • Unlimited users Business+
Ver todas las características (opens in a new tab)

Add-ons and Dedicated Node infrastructure are billed separately.

Users logoExceptional support on every paid plan
Preguntas frecuentes
What is TON RPC?

TON RPC gives applications programmatic access to The Open Network. Use it to read account balances, call smart contract get-methods, retrieve transactions, and submit signed messages. TON is not EVM-compatible: its HTTP APIs and native ADNL protocol differ from Ethereum’s eth_* methods. See the TON API reference.

How do I get a free TON RPC endpoint?

Create a free Chainstack account, create a project, and deploy a TON Global Node on mainnet or testnet. Open Access and credentials to copy your endpoint URL. The Developer plan includes 3 million request units per month, up to 25 requests per second, and one node. No credit card is required.

What are the TON mainnet and testnet RPC URLs?

Your authenticated base URLs follow https://ton-mainnet.core.chainstack.com/YOUR_ENDPOINT_ID y https://ton-testnet.core.chainstack.com/YOUR_ENDPOINT_ID. For v2 JSON-RPC, append /api/v2/jsonRPC. API v3 uses /api/v3, and Global Nodes also serve v4 at /api/v4. Copy your node’s full URL from Access and credentials. See TON API setup.

Should I use TON API v2, v3, or v4?

Use v2 for direct node reads, smart contract get-methods, and signed-message submission. Use v3 for indexed transactions, Jettons, NFTs, and traces. Use v4 for block-pinned account reads, TonClient4, and WebSocket block streams on Global Nodes. v3 data can lag behind node reads while indexing catches up. Compare TON API v2, v3, and v4.

How do I check a TON wallet balance?

Call getAddressBalance through the v2 API with the wallet’s address. The balance is returned as a string in nanotons, with one billion nanotons per native coin. This reads the native balance, not a Jetton balance. Use v3 Jetton wallet methods for token balances. See the getAddressBalance reference.

Can I build Telegram Mini Apps with a TON RPC endpoint?

Yes. Use a TON RPC endpoint for backend blockchain reads, transaction tracking, and signed-message submission. Use TON Connect to request wallet connections and user signatures in your application. RPC infrastructure does not replace Telegram’s Mini App APIs or TON Connect. See TON tooling and the official TON toolset.

How do I track USDT and other Jetton transfers on TON?

Use the v3 indexer’s /jetton/transfers endpoint to retrieve Jetton transfer records and /jetton/wallets for wallet data. Validate the Jetton master address rather than trusting a token symbol alone. For payment reconciliation, track transaction and message outcomes rather than treating submission as settlement. See the Jetton transfers reference.

Does Chainstack TON RPC support WebSockets?

Yes. TON API v4 on Global Nodes offers /block/watch for new masterchain blocks and /block/watch/changed for changed accounts. Use your authenticated v4 URL with the wss:// scheme and the required route. Streams can skip block sequence numbers, so fetch missing blocks when completeness matters. See TON API v4 routes.

Is TON archive data available, and how is it billed?

Chainstack’s TON documentation states that all historical data is available on every node, on mainnet and testnet. Full requests cost 1 request unit; archive requests cost 2. getTransactions is always archive. Block-based methods become archive when the requested sequence number is at least 128 behind the relevant chain tip. See TON request-unit rules.

What is ADNL, and does Chainstack support it?

ADNL is TON’s low-level network protocol. Chainstack Dedicated TON Nodes support ADNL for applications that need direct network-layer access. Global Nodes provide the application-facing HTTP APIs instead. Dedicated Nodes start from the Pro plan, with infrastructure billed separately. See TON tooling and ADNL access.

Which libraries work with Chainstack TON endpoints?

Use TonWeb or TonClient for compatible v2 integrations. Use TonClient4 from @ton/ton with your Global Node’s /api/v4 endpoint. Direct HTTP requests also work with JavaScript fetch and Python requests. Native liteserver libraries require ADNL connection details rather than an HTTPS URL. Follow the TON tooling guide.

Where can I get free TON testnet tokens?

Use the Chainstack TON testnet faucet to fund an eligible test wallet. The faucet currently tops balances up to 1 testnet GRAM, with a claim available every 24 hours. Test tokens have no monetary value and cannot pay mainnet fees. Connect your application and wallet to TON testnet.

TON RPC API: mainnet, testnet, and API versions

Connect to Chainstack’s TON mainnet or testnet endpoint to read account state, query Jetton and NFT data, execute smart contract get-methods, and submit serialized signed messages. Use /api/v2/jsonRPC for v2 JSON-RPC calls such as getAddressBalance, runGetMethod, y sendBoc. API v3 provides indexed transactions, messages, Jettons, NFTs, and traces. See the TON API reference.

On Global Nodes, TON API v4 uses /api/v4 for block-pinned reads and WebSocket block streams. Match your SDK to its API surface: TonClient4 uses v4, while compatible TonWeb and TonClient integrations use v2. ADNL access is available on Dedicated Nodes. Historical data is available on every TON node; requests consume 1 RU for full data or 2 RUs for archive data according to the method and block depth. See API version guidance y TON billing rules.