The Emulation API now supports the optional
mc_block_seqno parameter. You can emulate a transaction chain for a specific masterchain block. Only recent masterchain blocks (~7 days) are supported.π₯3π1
Instant appearance of pending transactions
Pending actions and transactions are now instantly available in the Pending API after message sending via Toncenter API.
Pending actions and transactions are now instantly available in the Pending API after message sending via Toncenter API.
π3β€1
New actions supported in Toncenter API
Multisig V2:
β Multisig order creation (
β Order approval (
β Order execution (
Vesting:
β Message sending (
β Adding to the whitelist (
Evaa:
β Supply (
β Withdraw (
β Liquidation (
Jvault:
β Stake (
β Unstake (
β Claim (
In addition, the current actions have been improved:
β Supported NFT discovery message (
β A definition of unsuccessful TON transfer (
β Improved support for Jetton Mint action: added support for mints that run with opcode
β Improved support for liquid staking (@stakee, Tonstakers) actions: added
https://toncenter.com/api/v3/index.html#/actions/api_v3_get_actions
Multisig V2:
β Multisig order creation (
multisig_create_order)β Order approval (
multisig_approve)β Order execution (
multisig_execute)Vesting:
β Message sending (
vesting_send_message)β Adding to the whitelist (
vesting_add_whitelist)Evaa:
β Supply (
evaa_supply)β Withdraw (
evaa_withdraw)β Liquidation (
evaa_liquidate)Jvault:
β Stake (
jvault_stake)β Unstake (
jvault_unstake)β Claim (
jvault_claim)In addition, the current actions have been improved:
β Supported NFT discovery message (
nft_discovery).β A definition of unsuccessful TON transfer (
ton_transfer) and Jetton transfer (jetton_transfer) has been added for cases where the execution failed on the sender's account (traces with a single transaction by an external message).β Improved support for Jetton Mint action: added support for mints that run with opcode
0x00000015. Previously, only 0x642b7d07 was supported.β Improved support for liquid staking (@stakee, Tonstakers) actions: added
tokens_minted and tokens_burnt fields to deposit/withdrawal operations. Improved the method of calculating how many TON a user receives for burning tokens upon withdrawal. Added the definition of the pool address when burning NFT vouchers (deferred deposit withdrawal).https://toncenter.com/api/v3/index.html#/actions/api_v3_get_actions
π3
Versioning in the Actions API
We introduce versioning for actions in https://toncenter.com/api/v3/.
Specify the "
Clients (e.g., wallet or blockchain explorers applications) can use it to receive the only actions that they support.
Version "
β 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 "
β 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 "
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.π4
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
β 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.π4β€1
ton-http-api 2.0.54
Normalized hash of external messages supported.
https://github.com/toncenter/ton-http-api
Normalized hash of external messages supported.
https://github.com/toncenter/ton-http-api
π3
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
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
π4
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.
The account history displays human-readable and user-friendly information, with almost no technical data.
π7π2
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.
The user receives a simple response in real time regarding the execution of the action in the blockchain.
π9π₯4β€1
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.
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.
π₯3β€1
New actions supported
Tonco.io DEX supported in the Toncenter Actions API:
New provider "
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.π₯5
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.
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.
β€3
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
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
β€5
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.
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.
π1
Toncenter API
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β¦
Streaming API (Websockets/SSE) is now available for everyone.
π1
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.
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.
β€9π₯6π€4
Decoded Message Bodies
Toncenter API now decodes message bodies using hundreds of known TLB schemes and returns the result in the
If your dAppβs smart contract uses a TLB scheme that isnβt decoded yet, please submit a pull request with the scheme definition.
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.
π9π₯6β€4π2
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.
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.
π8β€2π₯2