> ## Documentation Index
> Fetch the complete documentation index at: https://data.birdeye.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Token - Mint/Burn

> Retrieve the mint/burn transaction list of a specified token. Only support solana

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Mint and burn event history for one token.</strong></p>

    <ul>
      <li>This endpoint is Solana-only.</li>
      <li>Pass the token address in <code>address</code>.</li>
      <li><code>limit</code> supports up to <code>100</code> items per request and <code>offset</code> supports up to <code>10,000</code>.</li>
      <li>Filter by <code>type</code> to focus on mint events, burn events, or both.</li>
      <li>Use <code>after\_time</code> and <code>before\_time</code> for bounded event windows.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <li>Lite</li>
      <li>Starter</li>
      <li>Premium</li>
      <li>Business</li>
      <li>Enterprise</li>
    </ul>
  </Tab>

  <Tab title="Chain Supported">
    <p><strong>Solana</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>This endpoint consumes <code>15 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Track supply expansion and contraction through raw mint and burn events.</li>
    <li>Investigate treasury activity, token emissions, or deflation events.</li>
    <li>Build tokenomics dashboards that need event-level supply changes instead of just totals.</li>
    <li>Explain abrupt supply, liquidity, or price changes with the underlying mint or burn history.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Pass the token address in <code>address</code>.</li>
    <li>Filter by <code>type</code> and bound the window with <code>after\_time</code> and <code>before\_time</code>.</li>
    <li>Page with <code>offset</code> and <code>limit</code>, keeping <code>limit</code> at <code>100</code> or below.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Review mint and burn events alongside holder and transfer activity so supply moves are interpreted in context.</li>
    <li>Use bounded time windows around suspected emissions or treasury operations instead of scanning very broad ranges.</li>
    <li>Keep separate views for mint and burn when analyzing inflationary versus deflationary behavior.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Solana only.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /defi/v3/token/mint-burn-txs
openapi: 3.1.0
info:
  version: 1.1.0
  title: Birdeye Data API
  description: >-
    Birdeye Data API is a full-spectrum blockchain and DEX data platform for
    teams that need production-grade crypto market intelligence across tokens,
    pairs, wallets, traders, protocols, and chains.


    From real-time prices, OHLCV, liquidity, and transaction flow to holder
    analytics, token and pair overviews, wallet portfolio and PnL, smart money,
    discovery, security, and blockchain-level utilities, Birdeye gives you a
    unified data layer for building serious crypto products at scale.


    Use it to power exchange interfaces, trading terminals, bots, market-making
    systems, quant research, alpha screeners, portfolio apps, wallet
    intelligence tools, alerting systems, analytics dashboards, and back-office
    data pipelines. Whether your users are retail traders, pro desks, analysts,
    or infrastructure teams, Birdeye helps you ship faster with broad market
    coverage and API surfaces that support both lightweight integrations and
    data-heavy workflows.


    To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
    generate an API key from the `Security` tab, and send it in the `X-API-KEY`
    header on every request.
servers:
  - url: https://public-api.birdeye.so
security:
  - apiKeyAuth: []
tags:
  - name: Price & OHLCV
  - name: Stats
  - name: Token/Market List
  - name: Transactions
  - name: Wallet, Networth & PnL
  - name: Balance & Transfer
  - name: Holder
  - name: Alltime & History
  - name: Blockchain
  - name: Account
  - name: Token
  - name: Transaction
  - name: Creation & Trending
  - name: Meme
  - name: Security
  - name: Search & Utils
  - name: Smart Money
  - name: Global Fees Paid
  - name: DEX & Protocol
  - name: Wallet Identity
paths:
  /defi/v3/token/mint-burn-txs:
    get:
      tags:
        - Transactions
      summary: Token - Mint/Burn
      description: >-
        Retrieve the mint/burn transaction list of a specified token. Only
        support solana
      operationId: get-defi-v3-token-mint-burn-txs
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
        - $ref: '#/components/parameters/tokenAddressParam'
        - $ref: '#/components/parameters/sortByMintBurnTxsParam'
        - $ref: '#/components/parameters/sortTypeParam'
        - $ref: '#/components/parameters/typeMintBurnTxsParam'
        - $ref: '#/components/parameters/afterTimeMintBurnTxsParam'
        - $ref: '#/components/parameters/beforeTimeMintBurnTxsParam'
        - $ref: '#/components/parameters/offset10kParam'
        - $ref: '#/components/parameters/limit100Param'
      responses:
        '200':
          $ref: '#/components/responses/DefiTokenMintBurnTxs'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    xSolanaChainParam:
      name: x-chain
      description: Solana network only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
        default: solana
    tokenAddressParam:
      name: address
      description: The address of the token contract.
      in: query
      required: true
      schema:
        type: string
      examples:
        wsol:
          value: So11111111111111111111111111111111111111112
        solana:
          value: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
        ethereum:
          value: '0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce'
        solana_scaled_ui:
          value: Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh
    sortByMintBurnTxsParam:
      name: sort_by
      description: >-
        Specify the sort order for mint/burn transactions. Filter for records
        with sort order equal to the specified sort order.
      in: query
      required: true
      schema:
        type: string
        enum:
          - block_time
        default: block_time
    sortTypeParam:
      name: sort_type
      description: Specify the sort order.
      in: query
      required: true
      schema:
        type: string
        enum:
          - desc
          - asc
        default: desc
    typeMintBurnTxsParam:
      name: type
      description: >-
        Specify the type of mint/burn transactions. Filter for records with type
        equal to the specified type.
      in: query
      required: true
      schema:
        type: string
        enum:
          - all
          - mint
          - burn
        default: all
    afterTimeMintBurnTxsParam:
      name: after_time
      description: >-
        Specify the lower bound of time. Filter for records with time greater
        than the specified after time value, excluding those with time equal to
        the specified after time.
      in: query
      required: false
      schema:
        type: integer
    beforeTimeMintBurnTxsParam:
      name: before_time
      description: >-
        Specify the upper bound of time. Filter for records with time less than
        the specified before time value, excluding those with time equal to the
        specified before time.
      in: query
      required: false
      schema:
        type: integer
    offset10kParam:
      name: offset
      description: Pagination start position. offset + limit <= 10000
      in: query
      required: false
      schema:
        type: integer
        default: 0
        minimum: 0
        maximum: 10000
    limit100Param:
      name: limit
      description: Number of items per page.
      in: query
      required: false
      schema:
        type: integer
        default: 100
        minimum: 1
        maximum: 100
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Bad request
    '401':
      description: Unauthorized. API key is missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Unauthorized
    '403':
      description: Forbidden. Request is blacklisted or not whitelisted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Access Denied
    '429':
      description: Too Many Requests. Rate limit reached
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Too many requests
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Internal Server Error
    DefiTokenMintBurnTxs:
      description: JSON object containing a list of mint/burn transactions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DefiTokenMintBurnTxsResponse'
          examples:
            MintBurnTxs:
              value:
                success: true
                data:
                  items:
                    - amount: '870'
                      block_human_time: '2024-11-08T07:28:18.000Z'
                      block_time: 1731050898
                      common_type: burn
                      decimals: 0
                      mint: fueL3hBZjLLLJHiFH9cqZoozTG3XQZ53diwFPwbzNim
                      program_id: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                      slot: 300145960
                      tx_hash: >-
                        TyqmrBiZaW6bXsm6fV1owkVL2ea3PF2rbHPNZQtQrLYiZVThHEmkcD4QHKw37W43nyUdrFSdNr2xxTPZkPBY3pZ
                      ui_amount: 870
                      ui_amount_string: '870'
  schemas:
    DefiTokenMintBurnTxsResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            items:
              type: array
              items:
                type: object
                properties:
                  amount:
                    type: string
                  block_human_time:
                    type: string
                  block_time:
                    type: number
                  common_type:
                    type: string
                  decimals:
                    type: number
                  mint:
                    type: string
                  program_id:
                    type: string
                  slot:
                    type: number
                  tx_hash:
                    type: string
                  ui_amount:
                    type: number
                  ui_amount_string:
                    type: string
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````