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

# Burn List API v5

> Every token with burn data and its all-time totals

Every token with burn data, with its all-time burned amount and USD value, sorted by `tokenId`. Filter with `tokenId` (comma-separated slugs, no spaces). For one token's burn entries, use [Burn v5](https://docs.tokenomist.ai/api-documents/burn/v5.md).


## OpenAPI

````yaml GET /v5/burn/list
openapi: 3.0.3
info:
  title: Tokenomist API
  description: >-
    Comprehensive time series data for crypto token unlocks, emissions,
    allocations, fundraising, burns, and buybacks.
  version: 1.0.0
servers:
  - url: https://api.tokenomist.ai
security:
  - apiKey: []
paths:
  /v5/burn/list:
    get:
      tags:
        - Burn
      summary: Burn List v5
      description: >-
        Every token with burn data and its all-time totals, sorted by tokenId.
        Not available on the trial plan (403).
      operationId: getBurnListV5
      parameters:
        - name: tokenId
          in: query
          required: false
          description: >-
            Comma-separated token slugs (as in Token List v5), no spaces,
            matched exactly; unknown slugs are ignored. Omit for every token.
          schema:
            type: string
          example: aerodrome-finance
        - $ref: '#/components/parameters/V5Page'
        - $ref: '#/components/parameters/V5PageSize'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/PaginatedMetadata'
                  status:
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        tokenId:
                          type: string
                          description: Token slug
                          example: aerodrome-finance
                        tokenName:
                          type: string
                          description: Token name
                        tokenSymbol:
                          type: string
                          description: Token symbol
                        totalBurnAmount:
                          type: number
                          description: Tokens burned, all time
                          example: 407815.83378936
                        totalBurnValue:
                          type: number
                          nullable: true
                          description: >-
                            USD value of those entries, each at the price
                            described for pricePerToken; entries without a price
                            add 0. Null when none has a price.
                          example: 267379.56071216206
        '400':
          $ref: '#/components/responses/V5Error'
        '401':
          $ref: '#/components/responses/V5Error'
        '403':
          $ref: '#/components/responses/V5Error'
        '429':
          $ref: '#/components/responses/V5Error'
        '500':
          $ref: '#/components/responses/V5Error'
        '503':
          $ref: '#/components/responses/V5Error'
components:
  parameters:
    V5Page:
      name: page
      in: query
      required: false
      description: >-
        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.
      schema:
        type: integer
        minimum: 0
    V5PageSize:
      name: pageSize
      in: query
      required: false
      description: 'Rows per page. 0 or omitted: 20. No maximum. Negative: 400.'
      schema:
        type: integer
        minimum: 0
  schemas:
    PaginatedMetadata:
      type: object
      properties:
        queryDate:
          type: string
          format: date-time
          description: Timestamp of the query
          example: '2026-01-08T10:13:58Z'
        credit:
          $ref: '#/components/schemas/Credit'
        page:
          type: integer
          description: Current page number (1-based). 1 on an empty result.
          example: 1
        pageSize:
          type: integer
          description: Rows per page (20 by default).
          example: 50
        totalPages:
          type: integer
          description: Number of pages for this query (1 on an empty result).
          example: 10
        total:
          type: integer
          description: Number of rows across all pages. Left out when the result is empty.
          example: 487
    Credit:
      type: object
      description: >-
        Optional quota state for the calling account, returned on most
        authenticated responses (both success and error). Treat it as optional:
        it may be absent on unauthenticated requests, demo/playground responses,
        and briefly right after a monthly reset. `used` is near-real-time and
        may lag the true count by a request or two.
      properties:
        used:
          type: integer
          description: >-
            Successful requests (status below 400) made by your account, across
            all its keys, since the start of the month; errors use no credit.
            May lag by a request or two.
          example: 213
        limit:
          type: integer
          description: The plan's request quota for the window.
          example: 1000
        resetAt:
          type: string
          format: date-time
          description: 'When the quota resets: the 1st of next month, 00:00 UTC (RFC 3339).'
          example: '2026-08-01T00:00:00Z'
    V5ErrorBody:
      type: object
      properties:
        metadata:
          type: object
          properties:
            queryDate:
              type: string
              format: date-time
              example: '2026-11-03T09:10:52Z'
            credit:
              $ref: '#/components/schemas/Credit'
        status:
          type: boolean
          example: false
        statusCode:
          type: integer
          example: 403
        errorMessage:
          type: string
          example: This token is not supported
        data:
          type: array
          description: On a 422 validation error, the fields that failed.
          items:
            type: object
            properties:
              key:
                type: string
              value: {}
              message:
                type: string
  responses:
    V5Error:
      description: >-
        Error. Body: `status: false`, `statusCode`, `errorMessage`; `data` lists
        the failing fields on a 422 validation error. Errors use no credit. 400:
        a malformed parameter (a negative page, or a start/end date that is not
        YYYY-MM-DD; on the unlock events list, upcoming unlock events and
        investor list a malformed date is 422). 401: no `x-api-key`. 403: an
        unknown key or a plan without API access ("You are not authorized to
        access this resource"); the plan does not include this endpoint
        ("Forbidden"); the token is unknown or has no data for this dataset
        ("This token is not supported"); a trial-plan restriction. 404: the
        resource does not exist (allocations: the token has no standard
        allocation; investors: unknown `investorId`). 422: a date outside your
        plan's window, or an invalid filter value. 429: rate limit or monthly
        credit quota. 500, 503: server error, retry later.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V5ErrorBody'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.