TriportRPC
DashboardDocs

TON JSON-RPC methods

Send every method below to POST /rpc/ton in a JSON-RPC 2.0 envelope. All methods require x-token: $TRIPORT_API_KEY, the ton:rpc scope, and a by-name params object. In a batch, correlate responses by id, not array position.

Standard reads

MethodCategorySummaryTier / rate limit
getMasterchainInfoton_read_rpcReturn the current masterchain block, state root, and zero-state ID.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getTimeton_read_rpcReturn the selected liteserver's current Unix time.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getVersionton_read_rpcReturn version and capability data from the selected liteserver.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)

Heavy reads

MethodCategorySummaryTier / rate limit
getAddressInformationton_read_rpc_heavyRead account balance, state, code, data, and last-transaction metadata.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getBlockton_read_rpc_heavyReturn a serialized block body and its full block ID.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getBlockHeaderton_read_rpc_heavyReturn block metadata and proof material without the block body.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getConfigAllton_read_rpc_heavyReturn all available configuration cells at a masterchain point.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getConfigParamton_read_rpc_heavyReturn one numbered configuration cell at a masterchain point.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getShardston_read_rpc_heavyReturn active shardchain block IDs for a masterchain sequence.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
getTransactionston_read_rpc_heavyReturn account transactions newest-first with paired-cursor pagination.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
lookupBlockton_read_rpc_heavyResolve a block by sequence number, logical time, or Unix time.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
runGetMethodton_read_rpc_heavyExecute a read-only contract getter with legacy stack conventions.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)
runSmcMethodton_read_rpc_heavyExecute a read-only liteserver contract method with an explicit mode.free+; 15 / 20 / 100 / 250 RPS (default, unmeasured)

Network constraints

  • Public HTTP gateways are not used as upstreams. TON has no REST product surface, write methods, or WebSocket subscriptions here.
  • Pruned liteservers had a measured floor of 86 860 000. Two nodes answered from genesis, but only one had confirmed continuous history; ls-17 had a measured gap.
  • Accepted live fixtures mark selected BoC and proof fields as sanitized. Those placeholders document response shape and must not be treated as chain data.

See TON errors, TON rate limits, and the network overview.

Methods 13

POST getAddressInformation
Returns an account's balance, state, code, data, and last-transaction reference.
POST getBlock
Returns the serialized body of a TON block identified by its full block ID.
POST getBlockHeader
Returns block metadata and proof material without fetching the block body.
POST getConfigAll
Returns all available blockchain configuration cells at a masterchain point.
POST getConfigParam
Returns one numbered blockchain configuration cell at a masterchain point.
POST getMasterchainInfo
Returns the current masterchain block, state root, and zero-state reference.
POST getShards
Returns active shardchain block IDs at a masterchain sequence number.
POST getTime
Returns the current Unix time reported by the selected TON liteserver.
POST getTransactions
Returns an account's transactions newest-first with paired cursor pagination.
POST getVersion
Returns version and capability fields reported by the selected liteserver.
POST lookupBlock
Resolves one TON block by sequence number, logical time, or Unix time.
POST runGetMethod
Executes a read-only smart-contract getter using TON Center v2 JSON conventions.
POST runSmcMethod
Executes a read-only liteserver smart-contract method with an explicit mode.