> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# jetton/burns | TON v3

> The jetton/burns endpoint retrieves a list of Jetton burn events from the TON blockchain. Available on TON v3 via Chainstack JSON-RPC nodes.

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](https://tonviewer.com/EQCvxJy4eG8hyHBFsZ7eePxrRsUQSFE_jpptRAYBmcG_DOGS).

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## 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.


## OpenAPI

````yaml openapi/ton_node_api/v3/getJettonBurns.json GET /jetton/burns
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /jetton/burns:
    get:
      tags:
        - Jetton
      summary: Get Jetton Burns
      description: >-
        Retrieves a list of Jetton burn events for a specific Jetton address
        from the TON blockchain
      operationId: getJettonBurns
      parameters:
        - name: address
          in: query
          description: The address of the Jetton master contract
          required: true
          schema:
            type: string
            default: EQCvxJy4eG8hyHBFsZ7eePxrRsUQSFE_jpptRAYBmcG_DOGS
        - name: limit
          in: query
          description: The maximum number of burn events to return
          required: false
          schema:
            type: integer
            default: 128
        - name: offset
          in: query
          description: The number of burn events to skip before starting to return results
          required: false
          schema:
            type: integer
            default: 0
        - name: sort
          in: query
          description: The sorting order of the burn events
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  burns:
                    type: array
                    items:
                      type: object
                      properties:
                        jetton:
                          type: object
                          properties:
                            address:
                              type: string
                              description: The address of the Jetton master contract
                            name:
                              type: string
                              description: The name of the Jetton
                            symbol:
                              type: string
                              description: The symbol of the Jetton
                        burner:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                The address of the account that burned the
                                Jettons
                        transaction:
                          type: object
                          properties:
                            hash:
                              type: string
                              description: The hash of the transaction
                            time:
                              type: integer
                              description: The timestamp of the transaction
                        amount:
                          type: string
                          description: The amount of Jettons burned
                        comment:
                          type: string
                          description: Any comment attached to the burn event

````