Skip to main content
The TON Center API v3 provides developer access to the TON blockchain through an indexed data layer. It allows applications to read blockchain data, run analytical queries, retrieve historical information, and decode Jetton, NFT, and action data. API v3 serves as the indexed access layer. It reads raw data from a node’s RocksDB storage, parses and decodes it, and stores it in PostgreSQL.

Base URLs

APIMainnetTestnet
API v3https://toncenter.com/api/v3https://testnet.toncenter.com/api/v3

Typical use cases

  • Query historical transactions and traces
  • Retrieve decoded Jetton and NFT data
  • Run analytical or filtered searches across multiple accounts
  • Power explorers or reporting tools

Endpoints

CategoryMethodDescription
AccountsGET /accountStatesGet Account States
AccountsGET /addressBookAddress Book
AccountsGET /metadataMetadata
AccountsGET /walletStatesGet Wallet States
Actions and tracesGET /actionsGet Actions
Actions and tracesGET /pendingActionsGet Pending Actions
Actions and tracesGET /pendingTracesGet Pending Traces
Actions and tracesGET /tracesGet Traces
Blockchain DataGET /adjacentTransactionsGet Adjacent Transactions
Blockchain DataGET /blocksGet blocks
Blockchain DataGET /masterchainBlockShardStateGet masterchain block shard state
Blockchain DataGET /masterchainBlockShardsGet masterchain block shard state
Blockchain DataGET /masterchainInfoGet Masterchain Info
Blockchain DataGET /messagesGet messages
Blockchain DataGET /pendingTransactionsGet pending transactions
Blockchain DataGET /transactionsGet transactions
Blockchain DataGET /transactionsByMasterchainBlockGet transactions by Masterchain block
Blockchain DataGET /transactionsByMessageGet transactions by message
JettonsGET /jetton/burnsGet Jetton Burns
JettonsGET /jetton/mastersGet Jetton Masters
JettonsGET /jetton/transfersGet Jetton Transfers
JettonsGET /jetton/walletsGet Jetton Wallets
NFTsGET /nft/collectionsGet NFT collections
NFTsGET /nft/itemsGet NFT items
NFTsGET /nft/transfersGet NFT Transfers
DnsGET /dns/recordsGet DNS Records
MultisigGET /multisig/ordersGet Multisig Orders
MultisigGET /multisig/walletsGet Multisig Wallets
VestingGET /vestingGet Vesting Contracts
StatsGET /topAccountsByBalanceGet Top Accounts By Balance
UtilsGET /decodeDecode Opcodes and Bodies
Legacy (v2)GET /addressInformationGet Address Information
Legacy (v2)POST /estimateFeeEstimate Fee
Legacy (v2)POST /messageSend Message
Legacy (v2)POST /runGetMethodRun Get-Method
Legacy (v2)GET /walletInformationGet Wallet Information

How to access the API

Developers can access TON Center API v3 either through hosted infrastructure or by running a self-hosted instance.

Managed service

Hosted access uses TON Center’s indexed infrastructure.
Requests without an API key are rate-limited to a default value.
To increase limits, generate an API key and select a plan.

Self-hosted service

Run a self-hosted API v3 setup for full control over performance and data retention. See the ton-indexer repository for setup instructions.