The Open Network - REST API

REST API endpoints supported on The Open Network Mainnet and The Open Network Testnet through Tatum RPC Gateway, with base URLs and an example request.

Call The Open Network REST endpoints through Tatum RPC Gateway. Append the endpoint path to the network's base URL and send your API key in the x-api-key header. See Authentication.

The Open Network has 2 REST API interfaces, each with its own base URLs and endpoints: V3 - Indexer and V2 - TON HTTP API.

V3 - Indexer

Base URLs

NetworkBase URL
The Open Network Mainnethttps://ton-mainnet.gateway.tatum.io/api/v3
The Open Network Testnethttps://ton-testnet.gateway.tatum.io/api/v3

Example request

curl 'https://ton-mainnet.gateway.tatum.io/api/v3/masterchainInfo' \
  --header 'x-api-key: {YOUR_API_KEY}'

Endpoints

27 endpoints. Parameters and responses are described in the TON Center API v3 reference.

EndpointDescription
GET /accountStatesReturns the states of the given accounts.
GET /actionsReturns actions matching the specified filters.
GET /addressBookReturns the user-friendly forms of the given addresses.
GET /addressInformationReturns the smart contract information of an address.
GET /adjacentTransactionsReturns the parent and child transactions of a transaction.
GET /blocksReturns blocks matching the specified filters.
GET /eventsReturns events matching the specified filters.
GET /jetton/burnsReturns Jetton burns matching the specified filters.
GET /jetton/mastersReturns Jetton masters matching the specified filters.
GET /jetton/transfersReturns Jetton transfers matching the specified filters.
GET /jetton/walletsReturns Jetton wallets matching the specified filters.
GET /masterchainBlockShardsReturns the workchain blocks that appeared after the previous masterchain block.
GET /masterchainBlockShardStateReturns the shard state of a masterchain block.
GET /masterchainInfoReturns the first and last indexed masterchain blocks.
GET /messagesReturns messages matching the specified filters.
GET /nft/collectionsReturns NFT collections matching the specified filters.
GET /nft/itemsReturns NFT items matching the specified filters.
GET /nft/transfersReturns NFT transfers matching the specified filters.
GET /topAccountsByBalanceLists accounts sorted by balance in descending order.
GET /transactionsReturns transactions matching the specified filters.
GET /transactionsByMasterchainBlockReturns the transactions of a masterchain block and its shard blocks.
GET /transactionsByMessageReturns the transactions whose inbound or outbound message has a given hash.
GET /walletInformationReturns the wallet contract information of an address.
GET /walletStatesReturns the wallet states of the given addresses.
POST /estimateFeeEstimates the fees required to process a message.
POST /messageSends an external message to the network.
POST /runGetMethodRuns a get method of a smart contract.

The gateway lists its supported endpoints at runtime:

V2 - TON HTTP API

Base URLs

NetworkBase URL
The Open Network Mainnethttps://ton-mainnet.gateway.tatum.io
The Open Network Testnethttps://ton-testnet.gateway.tatum.io

Example request

curl 'https://ton-mainnet.gateway.tatum.io/getMasterchainInfo' \
  --header 'x-api-key: {YOUR_API_KEY}'

Endpoints

28 endpoints. Parameters and responses are described in the TON Center API v2 reference.

EndpointDescription
GET /detectAddressValidates an address and returns it in all standard formats.
GET /getAddressBalanceReturns the balance of an account in nanotons.
GET /getAddressInformationReturns the balance, code, data and last transaction ID of an account.
GET /getAddressStateReturns the state of an account: uninitialized, active or frozen.
GET /getBlockHeaderReturns the metadata of a block.
GET /getBlockTransactionsReturns a summary of the transactions in a block.
GET /getBlockTransactionsExtReturns the full transactions in a block.
GET /getConfigParamReturns a blockchain configuration parameter by ID.
GET /getConsensusBlockReturns the latest block confirmed by consensus and its timestamp.
GET /getExtendedAddressInformationReturns account information with the contract state parsed for known contract types.
GET /getMasterchainBlockSignaturesReturns the validator signatures of a masterchain block.
GET /getMasterchainInfoReturns the current state of the masterchain, including the latest block.
GET /getShardBlockProofReturns a Merkle proof linking a shardchain block to a masterchain block.
GET /getTokenDataReturns the metadata of a Jetton or NFT contract.
GET /getTransactionsReturns the transaction history of an account.
GET /getWalletInformationReturns the wallet details of an address, such as wallet type and seqno.
GET /lookupBlockFinds a block by seqno, logical time or Unix time.
GET /packAddressConverts a raw address to the user-friendly format.
GET /tryLocateResultTxFinds the transaction that received a given message.
GET /tryLocateSourceTxFinds the transaction that sent a given message.
GET /tryLocateTxFinds a transaction by the source, destination and creation time of its message.
GET /unpackAddressConverts a user-friendly address to the raw format.
POST /estimateFeeEstimates the fees required to process a message.
POST /jsonRPCCalls any HTTP API method through a single JSON-RPC endpoint.
POST /runGetMethodRuns a get method of a smart contract.
POST /sendBocBroadcasts a signed external message serialized as a BoC.
POST /sendBocReturnHashBroadcasts a signed external message serialized as a BoC and returns its hash.
POST /sendQuerySends an unpacked external message.

The gateway lists its supported endpoints at runtime:

Endpoint unavailable?

If you need an endpoint we don't support yet, contact support.