Burn
curl --request GET \
--url https://api.tokenomist.ai/v1/burn/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v1/burn/{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/burn/{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/burn/{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/burn/{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/burn/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v1/burn/{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": "aptos",
"tokenName": "Aptos",
"tokenSymbol": "APT",
"totalBurnAmount": 923.148539,
"totalBurnValue": 3046835887.80893,
"burns": [
{
"burnEventLabel": "Aptos Gas Fees",
"burnType": "PROGRAMMATIC",
"burnDate": "2024-12-02T00:00:00Z",
"amount": 511.326899,
"pricePerToken": 46.69,
"value": 466900000,
"metadata": {
"burners": [
"PROJECT"
],
"burnReasons": [
"GOVERNANCE"
]
}
}
]
}
}Burn
Burn API v1
Time series data of burn events: when and how tokens permanently removed from circulation
GET
/
v1
/
burn
/
{tokenId}
Burn
curl --request GET \
--url https://api.tokenomist.ai/v1/burn/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v1/burn/{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/burn/{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/burn/{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/burn/{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/burn/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v1/burn/{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": "aptos",
"tokenName": "Aptos",
"tokenSymbol": "APT",
"totalBurnAmount": 923.148539,
"totalBurnValue": 3046835887.80893,
"burns": [
{
"burnEventLabel": "Aptos Gas Fees",
"burnType": "PROGRAMMATIC",
"burnDate": "2024-12-02T00:00:00Z",
"amount": 511.326899,
"pricePerToken": 46.69,
"value": 466900000,
"metadata": {
"burners": [
"PROJECT"
],
"burnReasons": [
"GOVERNANCE"
]
}
}
]
}
}This documents the v1 endpoint, kept for existing integrations. The current version is burn 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
