TOtokenomist
Burn

Burn List v5

Changed on

Every token with burn data and its all-time totals, sorted by tokenId. Not available on the trial plan (403).

get/v5/burn/list

Request

  • Base URL
    https://api.tokenomist.ai
  • URL
    https://api.tokenomist.ai/v5/burn/list
  • Auth
    API key in header x-api-key

Query parameters

tokenIdstring

Comma-separated token slugs (as in Token List v5), no spaces, matched exactly; unknown slugs are ignored. Omit for every token.

pageinteger

Page number, 1-based. 0 or omitted: page 1. A page past the last returns the last page again, so stop at metadata.totalPages. Negative: 400.

pageSizeinteger

Rows per page. 0 or omitted: 20. No maximum. Negative: 400.

Response

Successful response

statusboolean

Example response

{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "data": [
    {
      "tokenId": "aerodrome-finance",
      "totalBurnAmount": 407815.83378936,
      "totalBurnValue": 267379.56071216206
    }
  ]
}

Changes