Burn v5
curl --request GET \
--url https://api.tokenomist.ai/v5/burn/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v5/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/v5/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/v5/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/v5/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/v5/burn/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v5/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 v5
Slug-based path identifier
GET
/
v5
/
burn
/
{tokenId}
Burn v5
curl --request GET \
--url https://api.tokenomist.ai/v5/burn/{tokenId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.tokenomist.ai/v5/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/v5/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/v5/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/v5/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/v5/burn/{tokenId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tokenomist.ai/v5/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"
]
}
}
]
}
}v5 update: Path identifier uses the token slug. Same params and response shape as v1.
Authorizations
Your Tokenomist API key
Path Parameters
Token identifier (slug). 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
