Toncenter API

The toncenter.com website and the @toncenter mini-app have been updated.

LLM-based content filtration in Toncenter API

Toncenter API now automatically filters inappropriate token images (NFTs and Jettons) using an LLM-based filtration system.

Following the reduction in TON transaction fees, spam and inappropriate content distributed as NFTs have become more noticeable on the network.

Building on its existing manual moderation tools, Toncenter has introduced an LLM-based image analyzer. Images flagged as inappropriate are now served by the API in blurred form. No changes are required for services already using Toncenter API.

Guidelines for Services

Toncenter API v3 metadata includes the following fields to help services handle potentially unsafe or malicious tokens:

- is_nsfw — marks tokens that have been identified as unsafe or potentially unsafe;
- is_scam — marks tokens associated with scams or spam;
- extra._image_big, extra._image_medium, and extra._image_small — contain links to processed token images. Images are resized to standard presets and automatically blurred when a token is marked as unsafe.

To better protect users, we recommend using an opt-in approach when displaying tokens in wallets, explorers, and other services.

By default, show only well-known or trusted tokens and their images. Other tokens and their images should be displayed only after the user explicitly chooses to enable them.

Please note: LLM-based filtering provides an additional layer of protection, but no automated filtering system can guarantee 100% accuracy. Both false negatives and false positives may occur.

Pending API and Streaming API Performance Improvements

We’ve shipped a major performance update to the Pending API, Streaming API and trace processing pipeline.

Key improvements:

— Moved action classification to C++ and integrated it directly into the Trace Emulator.
— Moved external message TTL tracking into the Trace Emulator, removing a separate service from the pipeline.
— Reduced Redis reads across trace processing and Streaming API.
— Made confirmed → finalized trace promotion significantly cheaper by avoiding full trace reprocessing.

With these changes, performance increased by a factor of 2.5. The system demonstrated stability during testing on a testnet at 1,500 TPS on the blockchain.

No changes are required on the part of customers.

New Indexer Database Architecture

The database has been divided into three tiers:

Hot — transactions from the last 2 week;
Cold — the complete transaction history;
Key-Value — states, BOCs, and metadata.

This makes processing queries to recent data, which account for most of the load, 2–4× faster.

The architecture is already used in toncenter.com/api/v3 and will later be available as a standalone build.

API V2 Hardware Update

The API V2 server infrastructure for direct requests to liteservers has been upgraded.

New Features

— A new API for nominator pools.

— A new API for validation cycles, including elections and complaints.

— Support for new DeDust V2 actions.

— Fixes and Improvements.

NFT Content Filtering

As network fees have decreased, the risk of spam and inappropriate content being distributed through NFTs has increased.

Toncenter has implemented a manual blacklist for individual NFTs and collections and is developing an automated LLM-based analyzer. Inappropriate pics will be displayed in a blurred form.

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