tokenomist-burn-buyback

name	tokenomist-burn-buyback
description	Check token burn and buyback activity. Use when analyzing deflationary mechanisms — burns, buybacks, and net inflation.
metadata	{"openclaw":{"requires":{"env":["TOKENOMIST_API_KEY"],"bins":["tok"]},"primaryEnv":"TOKENOMIST_API_KEY","install":[{"kind":"node","package":"@tokenomist-ai/tokenomist-cli","bins":["tok"]}]}}
allowed-tools	Bash(tok:*)

Skill: Burn & Buyback

Check token burn and buyback activity.

When to use

When you need to analyze deflationary mechanisms — how many tokens have been permanently burned or bought back from the market.

Commands

Burns

List all tokens with burns:

tok burn list --output json

Options:

Option	Description
--token-id <ids>	Filter by token IDs (comma-separated)
--page <number>	Page number
--page-size <number>	Items per page

tok burn list --token-id aptos,stellar --output json

Get burn events for a specific token:

tok burn detail <tokenId> --output json

Options:

Option	Description
--start <date>	Start date (YYYY-MM-DD)
--end <date>	End date (YYYY-MM-DD)

tok burn detail aptos --start 2024-01-01 --end 2024-12-31 --output json

Buybacks

List all tokens with buybacks:

tok buyback list --output json

Options:

Option	Description
--token-id <ids>	Filter by token IDs (comma-separated)
--page <number>	Page number
--page-size <number>	Items per page

tok buyback list --token-id aave --output json

Get buyback events for a specific token:

tok buyback detail <tokenId> --output json

Options:

Option	Description
--start <date>	Start date (YYYY-MM-DD)
--end <date>	End date (YYYY-MM-DD)

tok buyback detail aave --start 2024-01-01 --end 2024-12-31 --output json

Key output fields

Burn list:

• totalBurnAmount — total tokens burned for this token

Burn detail:

• burns[].burnDate — when the burn happened
• burns[].amount — tokens burned
• burns[].burnType — type of burn event
• burns[].metadata.burnReasons — why tokens were burned

Buyback list:

• totalBuybackAmount — total tokens bought back

Buyback detail:

• buybacks[].buybackDate — when the buyback happened
• buybacks[].tokenAmount — tokens bought back
• buybacks[].value — USD value of buyback
• buybacks[].spentAmount / spentUnit — what was spent (e.g. USDC)

Analysis workflow

1. List tokens with burns: tok burn list --output json
2. Compare totalBurnAmount across tokens to find most deflationary projects
3. Drill into a token: tok burn detail <id> --output json
4. Cross-reference with emissions from tok emission weekly <id> to calculate net inflation

Domain Context

• A sequential buyback + burn is a single deflationary event, not two. Counting both would double-count the supply reduction.
• Burns from locked supply don't reduce circulating supply — they reduce future potential supply instead.
• The startDate/endDate filters on burn/buyback detail commands filter by last activity date, not the event date range. This is an API quirk — the filters determine which tokens to include based on when they last had activity.

Workflow

• Cross-reference with tok emission weekly <id> to calculate net inflation: if burns exceed emissions, the token is net deflationary.
• Use tok token list --output json to check hasBurn/hasBuyback fields before querying detail commands (these fields are only visible in JSON output, not table mode).
• Compare totalBurnAmount across tokens to find the most deflationary projects.