$npx -y skills add tokenomist-ai/tokenomist-cli --skill tokenomist-burn-buybackCheck token burn and buyback activity. Use when analyzing deflationary mechanisms — burns, buybacks, and net inflation.
| 1 | # Skill: Burn & Buyback |
| 2 | |
| 3 | Check token burn and buyback activity. |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | When you need to analyze deflationary mechanisms — how many tokens have been permanently burned or bought back from the market. |
| 8 | |
| 9 | ## Commands |
| 10 | |
| 11 | ### Burns |
| 12 | |
| 13 | List all tokens with burns: |
| 14 | ```bash |
| 15 | tok burn list --output json |
| 16 | ``` |
| 17 | |
| 18 | Options: |
| 19 | | Option | Description | |
| 20 | |--------|-------------| |
| 21 | | `--token-id <ids>` | Filter by token IDs (comma-separated) | |
| 22 | | `--page <number>` | Page number | |
| 23 | | `--page-size <number>` | Items per page | |
| 24 | |
| 25 | ```bash |
| 26 | tok burn list --token-id aptos,stellar --output json |
| 27 | ``` |
| 28 | |
| 29 | Get burn events for a specific token: |
| 30 | ```bash |
| 31 | tok burn detail <tokenId> --output json |
| 32 | ``` |
| 33 | |
| 34 | Options: |
| 35 | | Option | Description | |
| 36 | |--------|-------------| |
| 37 | | `--start <date>` | Start date (YYYY-MM-DD) | |
| 38 | | `--end <date>` | End date (YYYY-MM-DD) | |
| 39 | |
| 40 | ```bash |
| 41 | tok burn detail aptos --start 2024-01-01 --end 2024-12-31 --output json |
| 42 | ``` |
| 43 | |
| 44 | ### Buybacks |
| 45 | |
| 46 | List all tokens with buybacks: |
| 47 | ```bash |
| 48 | tok buyback list --output json |
| 49 | ``` |
| 50 | |
| 51 | Options: |
| 52 | | Option | Description | |
| 53 | |--------|-------------| |
| 54 | | `--token-id <ids>` | Filter by token IDs (comma-separated) | |
| 55 | | `--page <number>` | Page number | |
| 56 | | `--page-size <number>` | Items per page | |
| 57 | |
| 58 | ```bash |
| 59 | tok buyback list --token-id aave --output json |
| 60 | ``` |
| 61 | |
| 62 | Get buyback events for a specific token: |
| 63 | ```bash |
| 64 | tok buyback detail <tokenId> --output json |
| 65 | ``` |
| 66 | |
| 67 | Options: |
| 68 | | Option | Description | |
| 69 | |--------|-------------| |
| 70 | | `--start <date>` | Start date (YYYY-MM-DD) | |
| 71 | | `--end <date>` | End date (YYYY-MM-DD) | |
| 72 | |
| 73 | ```bash |
| 74 | tok buyback detail aave --start 2024-01-01 --end 2024-12-31 --output json |
| 75 | ``` |
| 76 | |
| 77 | ## Key output fields |
| 78 | |
| 79 | **Burn list:** |
| 80 | - `totalBurnAmount` — total tokens burned for this token |
| 81 | |
| 82 | **Burn detail:** |
| 83 | - `burns[].burnDate` — when the burn happened |
| 84 | - `burns[].amount` — tokens burned |
| 85 | - `burns[].burnType` — type of burn event |
| 86 | - `burns[].metadata.burnReasons` — why tokens were burned |
| 87 | |
| 88 | **Buyback list:** |
| 89 | - `totalBuybackAmount` — total tokens bought back |
| 90 | |
| 91 | **Buyback detail:** |
| 92 | - `buybacks[].buybackDate` — when the buyback happened |
| 93 | - `buybacks[].tokenAmount` — tokens bought back |
| 94 | - `buybacks[].value` — USD value of buyback |
| 95 | - `buybacks[].spentAmount` / `spentUnit` — what was spent (e.g. USDC) |
| 96 | |
| 97 | ## Analysis workflow |
| 98 | |
| 99 | 1. List tokens with burns: `tok burn list --output json` |
| 100 | 2. Compare `totalBurnAmount` across tokens to find most deflationary projects |
| 101 | 3. Drill into a token: `tok burn detail <id> --output json` |
| 102 | 4. Cross-reference with emissions from `tok emission weekly <id>` to calculate net inflation |
| 103 | |
| 104 | ## Domain Context |
| 105 | |
| 106 | - A sequential buyback + burn is a **single** deflationary event, not two. Counting both would double-count the supply reduction. |
| 107 | - Burns from **locked** supply don't reduce circulating supply — they reduce future potential supply instead. |
| 108 | - 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. |
| 109 | |
| 110 | ## Workflow |
| 111 | |
| 112 | - Cross-reference with `tok emission weekly <id>` to calculate net inflation: if burns exceed emissions, the token is net deflationary. |
| 113 | - 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). |
| 114 | - Compare `totalBurnAmount` across tokens to find the most deflationary projects. |