GET
/
jetton
/
burns
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/jetton/burns
{
  "burns": [
    {
      "jetton": {
        "address": "<string>",
        "name": "<string>",
        "symbol": "<string>"
      },
      "burner": {
        "address": "<string>"
      },
      "transaction": {
        "hash": "<string>",
        "time": 123
      },
      "amount": "<string>",
      "comment": "<string>"
    }
  ]
}

The jetton/burns endpoint retrieves a list of Jetton burn events from the TON blockchain. This endpoint allows you to fetch information about Jettons that have been permanently removed from circulation and provides options for pagination and sorting.

Running the interactive example will return the amount of DOGS burned.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

TON pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
Parameters

  • limit (integer, optional) — The maximum number of burn events to return. Default: 128.
  • offset (integer, optional) — The number of burn events to skip before starting to return results. Default: 0.
  • sort (string, optional) — The sorting order of the burn events. Possible values: asc (ascending) or desc (descending). Default: desc.

​
Response

  • burns (array) — An array of Jetton burn event objects, each containing:
    • jetton (object) — Information about the burned Jetton:
      • address (string) — The address of the Jetton master contract.
      • name (string) — The name of the Jetton.
      • symbol (string) — The symbol of the Jetton.
    • burner (object) — Information about the account that burned the Jettons:
      • address (string) — The address of the burner.
    • transaction (object) — Information about the transaction:
      • hash (string) — The hash of the transaction.
      • time (integer) — The timestamp of the transaction.
    • amount (string) — The amount of Jettons burned.
    • comment (string) — Any comment attached to the burn event.

​
Use case

The jetton/burns endpoint is useful for various applications that need to track or analyze Jetton burn activities on the TON blockchain:

  1. Analytics platforms can use this to monitor the reduction in circulating supply of various Jettons.
  2. Wallet applications can show users their history of Jetton burn transactions.
  3. Developers can use this endpoint to build notification systems for significant burn events.
  4. Token issuers can track burn events to manage their token’s supply and verify proper functioning of burn mechanisms.
  5. Researchers can analyze burn patterns to study token economics and user behavior.
  6. Compliance tools can use this data to monitor large burns or burns from specific addresses.

Query Parameters

​
address
string
default:EQCvxJy4eG8hyHBFsZ7eePxrRsUQSFE_jpptRAYBmcG_DOGS
required

The address of the Jetton master contract

​
limit
integer
default:128

The maximum number of burn events to return

​
offset
integer
default:0

The number of burn events to skip before starting to return results

​
sort
enum<string>
default:desc

The sorting order of the burn events

Available options:
asc,
desc

Response

200 - application/json

Successful response

The response is of type object.