Get Jetton burns

Returns Jetton burn events matching the specified filters. Filter by owner address, Jetton wallet address, Jetton master address, or time range. Each burn includes the amount, query ID, and transaction reference.

GET /api/v3/jetton/burns

Get Jetton burns

cURL

curl --request GET \
  --url https://toncenter.com/api/v3/jetton/burns

200

{
  "address_book": {},
  "jetton_burns": [
    {
      "amount": "<string>",
      "custom_payload": "<string>",
      "decoded_custom_payload": [
        123
      ],
      "jetton_master": "<string>",
      "jetton_wallet": "<string>",
      "owner": "<string>",
      "query_id": "<string>",
      "response_destination": "<string>",
      "trace_id": "<string>",
      "transaction_aborted": true,
      "transaction_hash": "<string>",
      "transaction_lt": "0",
      "transaction_now": 123
    }
  ],
  "metadata": {}
}

Query Parameters

address · string[]

Address of jetton wallet owner in any form. Max 1000

jetton_wallet · string[]

Jetton wallet address in any form. Max: 1000.

jetton_master · string

Jetton master address in any form.

start_utime · integer<int32>

Query transactions with generation UTC timestamp after given timestamp.

Required range: x >= 0

end_utime · integer<int32>

Query transactions with generation UTC timestamp before given timestamp.

Required range: x >= 0

start_lt · integer<int64>

Query transactions with lt >= start_lt.

Required range: x >= 0

end_lt · integer<int64>

Query transactions with lt <= end_lt.

Required range: x >= 0

limit · integer<int32> · default: 10

Limit number of queried rows. Use with offset to batch read.

Required range: 1 <= x <= 1000

offset · integer<int32> · default: 0

Skip first N rows. Use with limit to batch read.

Required range: x >= 0

sort · enum<string> · default: desc

Sort transactions by lt.

Available options: asc, desc

Response

200 - application/json

Matching Jetton burn events with address book and metadata.

Response wrapper containing Jetton burn events with address book and token metadata.

address_book · object

Address book mapping raw addresses to user-friendly forms for all addresses referenced in the response.

Show child attributes

jetton_burns · object[]

Array of Jetton burn events matching the query filters.

Show child attributes

metadata · object

Token and indexing metadata for all addresses referenced in the response.

Show child attributes