Buyback
curl --request GET \
--url https://api.tokenomist.ai/v1/buyback/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v1/buyback/{tokenId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.tokenomist.ai/v1/buyback/{tokenId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tokenomist.ai/v1/buyback/{tokenId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tokenomist.ai/v1/buyback/{tokenId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tokenomist.ai/v1/buyback/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v1/buyback/{tokenId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"metadata": {
"queryDate": "2026-01-08T10:13:58Z",
"credit": {
"used": 213,
"limit": 300,
"resetAt": "2026-08-01T00:00:00Z"
}
},
"status": true,
"data": {
"tokenId": "hyperliquid",
"tokenName": "Hyperliquid",
"tokenSymbol": "HYPE",
"totalBuybackAmount": 318370.2349536178,
"buybacks": [
{
"buybackEventLabel": "Missing HYPE Assistance Fund Buyback",
"buybackType": "TREASURY_BUYBACK",
"buybackDate": "2024-11-30T17:00:00Z",
"tokenAmount": 159185.1174768089,
"value": 1036295.1147740259,
"spentAmount": 123,
"spentUnit": "",
"targetAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
"buyerAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
"resolution": "period_net",
"basis": "estimated"
}
]
}
}Buyback
Buyback API v1
Time series data of buyback events: when and how projects repurchase their own tokens from the market
GET
/
v1
/
buyback
/
{tokenId}
Buyback
curl --request GET \
--url https://api.tokenomist.ai/v1/buyback/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v1/buyback/{tokenId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.tokenomist.ai/v1/buyback/{tokenId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tokenomist.ai/v1/buyback/{tokenId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.tokenomist.ai/v1/buyback/{tokenId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.tokenomist.ai/v1/buyback/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v1/buyback/{tokenId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"metadata": {
"queryDate": "2026-01-08T10:13:58Z",
"credit": {
"used": 213,
"limit": 300,
"resetAt": "2026-08-01T00:00:00Z"
}
},
"status": true,
"data": {
"tokenId": "hyperliquid",
"tokenName": "Hyperliquid",
"tokenSymbol": "HYPE",
"totalBuybackAmount": 318370.2349536178,
"buybacks": [
{
"buybackEventLabel": "Missing HYPE Assistance Fund Buyback",
"buybackType": "TREASURY_BUYBACK",
"buybackDate": "2024-11-30T17:00:00Z",
"tokenAmount": 159185.1174768089,
"value": 1036295.1147740259,
"spentAmount": 123,
"spentUnit": "",
"targetAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
"buyerAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
"resolution": "period_net",
"basis": "estimated"
}
]
}
}This documents the v1 endpoint, kept for existing integrations. The current version is buyback v5. New integrations should use v5.
Authorizations
Your Tokenomist API key
Path Parameters
Token identifier. Get from Token List API.
Query Parameters
Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.
Was this page helpful?
⌘I
