TriportRPCDashboard

Network documentation

TON RPC API reference

Mainnet13 RPC methods

TON mainnet RPC endpoint: https://triport.io/rpc/ton (HTTPS). Requests need a Triport API key in the x-token header; the Free plan is a 7-day trial. Endpoint, plans and limits: TON RPC endpoint.

HTTPS endpointhttps://triport.io/rpc/ton
TON RPC endpointPlans, endpoints & pricing for TONTON chain ID, RPC URL & network configIdentifiers with sources, wallet setupBest TON RPC providers comparedPrices, rate limits and features, each with its source
All TON reference pages 16

JSON-RPC · ton read rpc heavy

JSON-RPC · ton read rpc

Guides & operations

Contracts

Capabilities

  • JSON-RPC readsAvailableFree+JSON-RPC over ADNL. Not included: sendBoc, estimateFee, getWalletInformation, a public stream, a continuous genesis archive.
  • Accounts, blocks and get-methodsAvailableFree+A known jetton wallet read is not discovery of every token an account holds.

Statuses reflect checks up to 2026-09-16. Rate limits are plan policy, not measured capacity.

Triport's TON facade exposes 13 read-only JSON-RPC methods over HTTPS, answered by a liteserver pool over encrypted binary ADNL. Params are by name: addresses may be raw or base64url, seqno is numeric, shard and logical time values are strings, and cells/proofs are base64. Batch responses are matched by id, not order.

For connection values, plans and what the endpoint does not do, see the TON RPC node endpoint.

Method / EndpointNetworkChain IDAuthenticationRequired scopeTier / rate limit
POST https://triport.io/rpc/tonTON mainnet—x-token: $TRIPORT_API_KEYton:rpcCategory-specific RPS; see Limits

Endpoints

SurfaceEndpointReference
HTTPShttps://triport.io/rpc/tonBackend path /rpc/ton

Quickstart

curl https://triport.io/rpc/ton \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getMasterchainInfo","params":{}}'

What's available

13 JSON-RPC methods in the OpenRPC catalog:

  • ton_read_rpc_heavy: 10
  • ton_read_rpc: 3

The measured floor on pruned liteservers is 86 860 000. Two nodes answered from genesis, but continuous genesis history is confirmed on one; one measured server has unconfirmed continuity after a gap. Archive selection is per-node and best-effort.

Limits

See network limits and Rate Limits & Tiers.

Finite request-rate budgets include a 2× burst buffer at no extra cost. It refills at sustained RPS; there is no quota on the number of bursts. Interval categories use seconds and have no RPS burst. See Burst capacity.

CategoryFreeBasicProBusinessEnterprise
ton_read_rpc15 RPS sustained · up to 30 burst20 RPS sustained · up to 40 burst100 RPS sustained · up to 200 burst250 RPS sustained · up to 500 burstunlimited
ton_read_rpc_heavy15 RPS sustained · up to 30 burst20 RPS sustained · up to 40 burst100 RPS sustained · up to 200 burst250 RPS sustained · up to 500 burstunlimited

Errors

See network-specific errors and the shared error reference.

Methods

ton read rpc heavy (10)

ton read rpc (3)

Streams

No mounted stream is published for this network.

JavaScript (fetch)

The same request from JavaScript (Node 18+ or the browser):

const res = await fetch("https://triport.io/rpc/ton", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"jsonrpc":"2.0","id":1,"method":"getMasterchainInfo","params":{}}),
});
const { result } = await res.json();
console.log(result);