Skip to main content
GET
/
v1
/
burn
/
{tokenId}
curl -X 'GET' \
  'https://api.unlocks.app/v1/burn/aptos?start=2024-12-01&end=2024-12-02' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2025-11-05T09:38:54Z"
    },
    "status": true,
    "data": {
        "tokenId": "aptos",
        "tokenName": "Aptos",
        "tokenSymbol": "APT",
        "totalBurnAmount": 923.148539,
        "burns": [
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-02T00:00:00Z",
                "amount": 511.326899,
                "metadata": {
                    "burners": ["PROJECT"],
                    "burnReasons": ["GOVERNANCE"]
                }
            },
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-01T00:00:00Z",
                "amount": 411.82164,
                "metadata": {
                    "burners": ["PROJECT"],
                    "burnReasons": ["GOVERNANCE"]
                }
            }
        ]
    }
}
Time series data of burn events: when and how tokens permanently removed from circulation.

​
Path Parameters

​
tokenId
string
required
Token identifier. Get tokenId from Token List API

​
Query Parameters

​
start
string
The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
​
end
string
The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.

​
Response

​
metadata
object
​
status
boolean
Request status
​
data
object
curl -X 'GET' \
  'https://api.unlocks.app/v1/burn/aptos?start=2024-12-01&end=2024-12-02' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2025-11-05T09:38:54Z"
    },
    "status": true,
    "data": {
        "tokenId": "aptos",
        "tokenName": "Aptos",
        "tokenSymbol": "APT",
        "totalBurnAmount": 923.148539,
        "burns": [
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-02T00:00:00Z",
                "amount": 511.326899,
                "metadata": {
                    "burners": ["PROJECT"],
                    "burnReasons": ["GOVERNANCE"]
                }
            },
            {
                "burnEventLabel": "Aptos Gas Fees",
                "burnType": "PROGRAMMATIC",
                "burnDate": "2024-12-01T00:00:00Z",
                "amount": 411.82164,
                "metadata": {
                    "burners": ["PROJECT"],
                    "burnReasons": ["GOVERNANCE"]
                }
            }
        ]
    }
}