Tokenomist burn buyback
Skill tokenomist-ai/tokenomist-cli/skills/tokenomist-burn-buyback
CLI and AI agent skills for the Tokenomist crypto data API: token unlocks, vesting, emissions, allocations, fundraising, burns and buybacks.
npx -y skills add tokenomist-ai/tokenomist-cli --skill tokenomist-burn-buybackAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Check token burn and buyback activity. Use when analyzing deflationary mechanisms — burns, buybacks, and net inflation.
SKILL.md
3.8 KB, as published. Nobody here has run it
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 happenedburns[].amount— tokens burnedburns[].burnType— type of burn eventburns[].metadata.burnReasons— why tokens were burned
Buyback list:
totalBuybackAmount— total tokens bought back
Buyback detail:
buybacks[].buybackDate— when the buyback happenedbuybacks[].tokenAmount— tokens bought backbuybacks[].value— USD value of buybackbuybacks[].spentAmount/spentUnit— what was spent (e.g. USDC)
Analysis workflow
- List tokens with burns:
tok burn list --output json - Compare
totalBurnAmountacross tokens to find most deflationary projects - Drill into a token:
tok burn detail <id> --output json - 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/endDatefilters 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 jsonto checkhasBurn/hasBuybackfields before querying detail commands (these fields are only visible in JSON output, not table mode). - Compare
totalBurnAmountacross tokens to find the most deflationary projects.