Note: There are no changes to the Toncenter API following the renaming of the Toncoin to Gram.

The outage of toncenter.com services was fixed.
This problem was caused by issue in Cloudflare healthcheck of our infrastructure.

Cocoon AI smart contract actions are now supported

Starting with v1.2.6, the Toncenter Indexer supports the following Cocoon AI smart contract actions along with their decoded message bodies:

• cocoon_worker_payout

• cocoon_proxy_payout

• cocoon_proxy_charge

• cocoon_client_top_up

• cocoon_register_proxy

• cocoon_unregister_proxy

• cocoon_client_register

• cocoon_client_change_secret_hash

• cocoon_client_request_refund

• cocoon_grant_refund

• cocoon_client_increase_stake

• cocoon_client_withdraw

Use https://toncenter.com/api/v3/index.html#/actions with supported_action_types=latest.

Introducing Streaming API V2

The new Streaming API V2 allows you to create an even faster and smoother UX in your products. This innovation is part of the upcoming global “Sub-Second” update of the TON network.

Documentation »

The deprecation plan for Streaming API V1 will be announced later.

Decoded Message Bodies

Toncenter API now decodes message bodies using hundreds of known TLB schemes and returns the result in the Message.message_content.decoded field. Previously, only the text_comment type was recognized; the API now supports 800+ TLB schemes. This means responses may include new decoded types and richer structures. Update your parsers to read decoded defensively.

If your dApp’s smart contract uses a TLB scheme that isn’t decoded yet, please submit a pull request with the scheme definition.

Overview of New Features in the Toncenter API

The first half of this year was dedicated to expanding the Toncenter API with powerful new features that apps and services can leverage to deliver an exceptional user experience.

— Actions API
The Actions API can detect patterns in sequences of blockchain transactions and return user-friendly data, such as “Exchange 1,000 USDt on DeDust DEX”, “Deposit TON into @stakee staking”, or “Bid in a Telegram Gift auction”.

Since its initial release, the API has undergone several updates using a convenient versioning system. With each version — v1, v2, and etc — the number of supported actions and services has continued to grow.

— Pending API
This API allows you to track blockchain operations that are still in progress. Messages sent to the blockchain appear instantly in this API, along with their processing status.

— Standardized Action IDs
Normalized extrernal message hash are now standardized, ensuring a reliable way to locate and track any sent message within the TON Blockchain. This is especially useful when monitoring pending actions.

— Streaming API (WebSockets / SSE)
The Streaming API provides real-time updates on both pending and confirmed transactions and actions.

— Emulation API
The Emulation API predicts what actions will occur before a message is sent to the blockchain, improving both user convenience and safety.

— Metadata API Enhancements
This API allows retrieval of cached token metadata, including icons and additional descriptive information.

— Traces API Enhancements
Transaction trace detection has been improved, with better recognition of related transaction series on the blockchain.

— TON DNS Support

— Get-method ID Support

Most of these features were not only introduced but also iterated on multiple times, with refinements improving their usability and accuracy.

We’re proud to equip developers with powerful new tools—and even prouder that leading TON products have already adopted them, driving a leap forward in UI and UX. More on this in the next post.

Streaming API (Websockets/SSE) is now available for everyone.

Dear users of toncenter.com/api/index

This old version of indexer service is deprecated since December 31, 2024 and will be completely disabled after August 10, 2025. We kindly ask you to migrate to new indexer API v3: toncenter.com/api/v3.

Streaming API - Websockets/SSE for Enterprise Plan

We’re excited to announce that Toncenter has launched a Streaming API! This API enables real-time updates about pending and committed transactions and actions, filtered by specified addresses. The API supports both Server-Sent Events (SSE) and WebSocket protocols, offering flexibility for integration.

Currently, the Streaming API is available exclusively to Enterprise clients. In particular, the non-custodial wallet MyTonWallet has already begun to implement this feature for instant display of incoming transactions.

The Streaming API will soon be available to everyone.

Documentation

Get-methods IDs

Now, the /accountStates response returns a list of smart contract get method IDs. Based on the presence of certain get methods, you can determine the type of some smart contracts. Adding get method indexing has also improved the accuracy of our Actions API.

New actions supported

Tonco.io DEX supported in the Toncenter Actions API:

New provider "tonco" added to existing DEX actions: jetton_swap, dex_deposit_liquidity, dex_withdraw_liquidity; tonco_create_pool action added.

tonscan.org uses Toncenter Actions V2

Based on Toncenter Actions API v2 update, the popular blockchain explorer tonscan.org has start to display operations with multisig, vesting, EVAA, and Jvault services.

It is also worth noting the extended support for multisig: the explorer now displays a list of signers, proposers, multisig info and the contents of the multisig order that will be executed after signing.

Tonscan.org displays the percentage of an action completed using the Toncenter Pending API

The user receives a simple response in real time regarding the execution of the action in the blockchain.

Tonscan.org has made it even easier to display account history using the Toncenter Actions API

The account history displays human-readable and user-friendly information, with almost no technical data.

DeDust DEX now provides an instant link to pending action

After the exchange, you will immediately receive a link to the blockchain explorer, which you can share or use to track the transaction.

Please note that the DeDust DEX user interface does not block you, and you can make a new exchange even if the previous one is still in progress.

https://dedust.io/swap

MyTonWallet now provides an instant link to pending action

@MyTonWalletEn243

MyTonWallet uses the Toncenter Emulation API

@MyTonWalletEn245

ton-http-api 2.0.54

Normalized hash of external messages supported.

https://github.com/toncenter/ton-http-api

Emulation and Pending API Updates

— In the Emulation API and Pending API, transaction chains are now emulated more accurately.
Previously, all transactions in a chain were emulated for a single block. Now, the emulator distributes transactions across different blocks (for example, an inter-shard message will occupy several blocks).
This allows for more accurate prediction of transaction order and results, as well as approximate timestamps and lt values for transactions, which makes it possible to estimate approximate execution times.

— Emulation API: added address_book and metadata.

Versioning in the Actions API

We introduce versioning for actions in https://toncenter.com/api/v3/.

Specify the "supported_action_types" in methods api/v3/traces and api/v3/actions to desired version of action types and get the actions of supported types or set it to "latest" to get all newest actions from API v3.

Clients (e.g., wallet or blockchain explorers applications) can use it to receive the only actions that they support.

Version "v1":
— Basic: call_contract, contract_deploy, ton_transfer, tick_tock
— Jettons: jetton_burn, jetton_transfer, jetton_mint
— NFTs: nft_mint, nft_transfer, auction_bid
— DEXs: jetton_swap, dex_deposit_liquidity, dex_withdraw_liquidity
— Liquid staking: stake_deposit, stake_withdrawal, stake_withdrawal_request
— Elections: election_deposit, election_recover
— TON DNS: change_dns, delete_dns, renew_dns
— Subsctiptions: subscribe, unsubscribe

Version "v2":
— Multisig: multisig_create_order, multisig_approve, multisig_execute
— Vesting: vesting_send_message, vesting_add_whitelist
— EVAA: evaa_supply, evaa_withdraw, evaa_liquidate
— Jvault: jvault_stake, jvault_unstake, jvault_claim
— NFTs: nft_discovery

Version "latest": returns all newest action types.