Skip to main content
GET
/
v5
/
burn
/
{tokenId}
Burn v5
curl --request GET \
  --url https://api.tokenomist.ai/v5/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"
          ]
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.tokenomist.ai/llms.txt

Use this file to discover all available pages before exploring further.

v5 update: Path identifier uses the token slug. Same params and response shape as v1.

Authorizations

​
x-api-key
string
header
required

Your Tokenomist API key

Path Parameters

​
tokenId
string
required

Token identifier (slug). 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