Toncenter extended plans

We have done extensive work on upgrading the Toncenter infrastructure and are happy to note that now more than 100 servers are running on our system. In addition, we have implemented the ability to dynamically add new ton-http-api instances in runtime.

In order to be able to provide you with the expected level of performance we are introducing extended plans:

— Free: 1 API Key, 10 RPS;

— Plus: 3 API Keys, 25 RPS, Privately hosted Liteservers, 5.9 TON / month;

— Advanced: 10 API Keys, 100 RPS, Privately hosted Liteservers, 59 TON / month;

Free open source code is still available, so you can run a fully functional api yourself.

We guarantee that a free plan will always exist at toncenter.com, for a quick start for developers. However, if you are developing a popular service or a service that needs high uptime, we recommend that you consider an extended plan.

You can check out the plans in our bot @tonapibot.

Toncenter API v3 updates

— Method /api/v3/transactions now supports querying transactions for multiple account using parameter "account".

— Method /api/v3/nft/items can find NFT in collection by it's index.

Prices for extended plans have been reduced to 2.5 TON and 25 TON.

ton-http-api 2.0.42 is released!

For correct work with jettons developers, services and exchanges should always make all checks described here.

For your convenience, we added check #3 from list above directly to getTokenData endpoint of ton-http-api version 2.0.42.

Now correspondence between jetton wallet and it's jetton master is checked both in toncenter v2 and toncenter v3 API endpoints (in v3 such a check existed from beginning).

If you are using local ton-http-api please update!

https://github.com/toncenter/ton-http-api/releases/tag/v2.0.42

Maintenance of TON Center

In next couple hours we have to restart all Lite Servers, so toncenter.com/api/v2 and toncenter.com/api/v3 will by out of sync for 5-10 minutes during this period of time.

The maintenance is finished. Total out of sync time is 10,5 minutes.

Old /index API is deprecated

Old Toncenter Index API https://toncenter.com/api/index/ is deprecated and will stop working on December 31, 2024.

Please switch your products to the Toncenter Index V3 API https://toncenter.com/api/v3, which is much faster and more functional.

Toncenter Technical Support

If you find a bug or issue in Toncenter, you can report it to @toncenter_support. Messages are processed in order of priority.

Mintless jettons support

Toncenter supports mintless jettons, check on preview.toncenter.com!

Now for jettons that allow mintless claim v3/jetton/wallets API returns additional field:

"mintless_info": {
    "amount": "<amount-as-string>",
    "start_from": <unix-timestamp>,
    "expire_at": <unix-timestamp>
}

How to support mintless jettons in your dapp?
— To show balance with mintless, use data["balance"] + data["mintless_info"]["amount"]
— To autoclaim on transaction, when your dapp asks user to send outgoing jetton transfer via TonConnect, check if data["mintless_info"] is present and retrieve from mintless jetton claim api custom_payload and init_data to fill them in to transfer.
— That's it. Now you support mintless jettons!


P.S. Note that now code_hash and data_hash fields can be null for not yet deployed jettons wallets.

Partial out of sync for API v3

We've faced out of sync for some of our indexer databases from 5:45utc to 8:15utc. Now the issue is fixed.

We are pleased to announce that the mainnet API key bot is available at the new short username @toncenter.

Due to network issues the API v3 was out of sync from 13:48UTC to 13:54UTC. Now, the API v3 is fully operational.

Introducing the Domain API

Now the /accountStates method returns the .ton/.t.me domain bound to the specified account in the address_book field.

In other methods, such as transaction list, you will also find domains in address_book.

In case there are several domains bound to an account, the shortest one is returned.

Mainnet API

Introducing the Action API

The Toncenter Indexer now recognizes user-friendly actions among transaction series, such as staking, exchanging Jettons on DeDust DEX, or sending NFTs. A set of filters is available.

Supported Actions:

Basic
— Toncoin transfer
— Call contract
— Contract deploy

System
— Deposit stake to elector
— Recover stake to elector
— Tick-tock

Jettons
— Transfer
— Burn
— Mint

NFT
— Transfer
— Mint

Nominator Pool
— Deposit
— Withdraw

@stakee/TonStakers
— Deposit
— Withdraw

DeDust DEX
— Swap
— Add liquidity
— Withdraw liquidity

Ston-fi DEX
— Swaps v1
— Swaps v2
— Add liquidity v2
— Withdraw liquidity v2

NFT Auctions
— Bidding (Fragment, ton.diamonds, Getgems)

TON DNS
— Renew domain
— Change DNS record
— Delete DNS record

W4R2 Toncoin Subscriptions
— Subscribe
— Unsubscribe

The Toncenter team will continue to work and will be adding new action types in the next versions.

Also the /trace method now supports the incude_actions=true parameter, which will also return a list of actions related to this transaction series.

Mainnet API

Testnet API

Introducing the Emulation API

Using this API you can simulate the result of sending a message to the blockchain, before sending it.

The API predicts not only raw transactions, but also recognizes known user-friendly actions among them.

This will allow the user to see what happens if they sign the send, as well as estimate the total fees.

Mainnet API

Testnet API

Support for extra-currencies in local ton-http-api

In ton-http-api v2.0.53, which you can install by yourself on your server, support for extra-currencies and a number of other improvements have been made.

Recall that earlier support for extra-currencies was made in the public Toncenter V2 and Toncenter V3 APIs.

https://github.com/toncenter/ton-http-api/releases/tag/v2.0.53

Improved Metadata API

Last month we started providing metadata for Jettons and NFTs in the V3 API.

We are pleased to report a number of improvements:

— The metadata now enters the API in advance as soon as the token appears on the network. In the previous implementation, the metadata was indexed the first time the token was requested.

— Images and JSON are now proxied via toncenter.com. 3 image sizes are available, as well as original non-proxied urls for JSON and images. IPFS is supported.
Using a proxy increases security (you don't make requests to third-party hosting) and speed of downloading resources.

Now you can get all .ton and .t.me domains bound to a specific wallet using the new /dns/records method.

https://toncenter.com/api/v3/index.html#/dns/api_v3_get_dns_records

Now /api/v3/jetton/wallets supports the jetton_address array[string] field and /api/v3/nft/items supports the collection_address array[string] field.

You can request selected user jettons or NFTs, for example to display the most popular ones.

The peer_swaps field has been added to the Action API for complex swaps on DEXes. This field contains information about intermediate swaps (exchanges).

Emulation API now uses the same response models for transactions, messages, and actions as Index API v3.

Additionally, is_incomplete flag has been added to indicate if the emulated trace was truncated due to size limits.