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

# Buyback API v1

> Time series data of buyback events: when and how projects repurchase their own tokens from the market

<Warning>
  This documents the **v1** endpoint, kept for existing integrations. The current version is [buyback v5](/api-documents/buyback/v5). New integrations should use v5.
</Warning>

Time series data of buyback events: when and how projects repurchase their own tokens from the market.


## OpenAPI

````yaml GET /v1/buyback/{tokenId}
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:
  /v1/buyback/{tokenId}:
    get:
      tags:
        - Buyback
      summary: Buyback
      description: >-
        Time series data of buyback events: when and how projects repurchase
        their own tokens from the market.
      operationId: getBuyback
      parameters:
        - name: tokenId
          in: path
          required: true
          description: Token identifier. Get from Token List API.
          schema:
            type: string
          example: hyperliquid
        - name: start
          in: query
          required: false
          description: >-
            Start date for time filtering (YYYY-MM-DD). Defaults to earliest
            available date.
          schema:
            type: string
            format: date
        - name: end
          in: query
          required: false
          description: >-
            End date for time filtering (YYYY-MM-DD). Defaults to furthest
            available date.
          schema:
            type: string
            format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/Metadata'
                  status:
                    type: boolean
                  data:
                    type: object
                    properties:
                      tokenId:
                        type: string
                        example: hyperliquid
                      tokenName:
                        type: string
                        example: Hyperliquid
                      tokenSymbol:
                        type: string
                        example: HYPE
                      totalBuybackAmount:
                        type: number
                        example: 318370.2349536178
                      buybacks:
                        type: array
                        items:
                          $ref: '#/components/schemas/BuybackEvent'
components:
  schemas:
    Metadata:
      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'
    BuybackEvent:
      type: object
      properties:
        buybackEventLabel:
          type: string
          description: Label of buyback event
          example: Missing HYPE Assistance Fund Buyback
        buybackType:
          type: string
          description: Type of buyback event
          example: TREASURY_BUYBACK
        buybackDate:
          type: string
          format: date-time
          description: Date of buyback
          example: '2024-11-30T17:00:00Z'
        tokenAmount:
          type: number
          description: Buyback token amount
          example: 159185.1174768089
        value:
          type: number
          description: Historical USD value of token amount
          example: 1036295.1147740259
        spentAmount:
          type: number
          nullable: true
          description: Amount actually spent by the project to buy back tokens
        spentUnit:
          type: string
          description: Unit of spent amount
          example: ''
        targetAddress:
          type: string
          description: Address of the buyback wallet or foundation
          example: '0xfefefefefefefefefefefefefefefefefefefefe'
        buyerAddress:
          type: string
          description: >-
            Address doing the buyback purchases (usually target address if
            unknown)
          example: '0xfefefefefefefefefefefefefefefefefefefefe'
        resolution:
          type: string
          description: Granularity of buyback event
          example: period_net
        basis:
          type: string
          description: Precision of the buyback reference
          example: estimated
    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: >-
            Requests counted in the current window (approximate / eventually
            consistent).
          example: 213
        limit:
          type: integer
          description: The plan's request quota for the window.
          example: 300
        resetAt:
          type: string
          format: date-time
          description: >-
            When the quota resets (RFC3339 UTC). Present for monthly plans;
            absent for lifetime-quota plans.
          example: '2026-08-01T00:00:00Z'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key

````