API v3 overview

The TON Center API v3 provides developer access to 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

API	Mainnet	Testnet
API v3	https://toncenter.com/api/v3	https://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

Category	Method	Description
Accounts	GET /accountStates	Get Account States
Accounts	GET /addressBook	Address Book
Accounts	GET /metadata	Metadata
Accounts	GET /walletStates	Get Wallet States
Actions and traces	GET /actions	Get Actions
Actions and traces	GET /pendingActions	Get Pending Actions
Actions and traces	GET /pendingTraces	Get Pending Traces
Actions and traces	GET /traces	Get Traces
Blockchain Data	GET /adjacentTransactions	Get Adjacent Transactions
Blockchain Data	GET /blocks	Get blocks
Blockchain Data	GET /masterchainBlockShardState	Get masterchain block shard state
Blockchain Data	GET /masterchainBlockShards	Get masterchain block shard state
Blockchain Data	GET /masterchainInfo	Get Masterchain Info
Blockchain Data	GET /messages	Get messages
Blockchain Data	GET /pendingTransactions	Get pending transactions
Blockchain Data	GET /transactions	Get transactions
Blockchain Data	GET /transactionsByMasterchainBlock	Get transactions by Masterchain block
Blockchain Data	GET /transactionsByMessage	Get transactions by message
Jettons	GET /jetton/burns	Get Jetton Burns
Jettons	GET /jetton/masters	Get Jetton Masters
Jettons	GET /jetton/transfers	Get Jetton Transfers
Jettons	GET /jetton/wallets	Get Jetton Wallets
NFTs	GET /nft/collections	Get NFT collections
NFTs	GET /nft/items	Get NFT items
NFTs	GET /nft/transfers	Get NFT Transfers
Dns	GET /dns/records	Get DNS Records
Multisig	GET /multisig/orders	Get Multisig Orders
Multisig	GET /multisig/wallets	Get Multisig Wallets
Vesting	GET /vesting	Get Vesting Contracts
Stats	GET /topAccountsByBalance	Get Top Accounts By Balance
Utils	GET /decode	Decode Opcodes and Bodies
Legacy (v2)	GET /addressInformation	Get Address Information
Legacy (v2)	POST /estimateFee	Estimate Fee
Legacy (v2)	POST /message	Send Message
Legacy (v2)	POST /runGetMethod	Run Get-Method
Legacy (v2)	GET /walletInformation	Get 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.