---
title: "Buyback"
method: GET
path: "/v1/buyback/{tokenId}"
tags: ["Buyback"]
---

# Buyback

`GET /v1/buyback/{tokenId}`

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

## Path parameters

- `tokenId` string, required

## Query parameters

- `start` string, date
- `end` string, date

## Response `200`

Successful response

- object
  - `metadata` Metadata
    - `queryDate` string, date-time — Timestamp of the query
    - `credit` Credit — 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.
      - `used` integer — Requests counted in the current window (approximate / eventually consistent).
      - `limit` integer — The plan's request quota for the window.
      - `resetAt` string, date-time — When the quota resets (RFC3339 UTC). Present for monthly plans; absent for lifetime-quota plans.
  - `status` boolean
  - `data` object
    - `tokenId` string
    - `tokenName` string
    - `tokenSymbol` string
    - `totalBuybackAmount` number
    - `buybacks` BuybackEvent[]
      - `buybackEventLabel` string — Label of buyback event
      - `buybackType` string — Type of buyback event
      - `buybackDate` string, date-time — Date of buyback
      - `tokenAmount` number — Buyback token amount
      - `value` number — Historical USD value of token amount
      - `spentAmount` number, nullable — Amount actually spent by the project to buy back tokens
      - `spentUnit` string — Unit of spent amount
      - `targetAddress` string — Address of the buyback wallet or foundation
      - `buyerAddress` string — Address doing the buyback purchases (usually target address if unknown)
      - `resolution` string — Granularity of buyback event
      - `basis` string — Precision of the buyback reference

---

[API](https://skmtc.net/tokenomist/apis/tokenomist-api.md) · [All operations](https://skmtc.net/tokenomist/apis/tokenomist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tokenomist/tokenomist-api/revisions/1d812f25c55a/schema)