Skip to main content
GET
/
v1
/
burn
/
{tokenId}
Burn
curl --request GET \
  --url https://api.tokenomist.ai/v1/burn/{tokenId} \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "tokenId": "aptos",
    "tokenName": "Aptos",
    "tokenSymbol": "APT",
    "totalBurnAmount": 923.148539,
    "burns": [
      {
        "burnEventLabel": "Aptos Gas Fees",
        "burnType": "PROGRAMMATIC",
        "burnDate": "2024-12-02T00:00:00Z",
        "amount": 511.326899,
        "metadata": {
          "burners": [
            "PROJECT"
          ],
          "burnReasons": [
            "GOVERNANCE"
          ]
        }
      }
    ]
  }
}
Time series data of burn events: when and how tokens permanently removed from circulation.

Authorizations

x-api-key
string
header
required

Your Tokenomist API key

Path Parameters

tokenId
string
required

Token identifier. Get from Token List API.

Query Parameters

start
string<date>

Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.

end
string<date>

End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.

Response

200 - application/json

Successful response

metadata
object
status
boolean
data
object