# Tokenomist Burn Buyback

> Check token burn and buyback activity. Use when analyzing deflationary mechanisms — burns, buybacks, and net inflation.

- Skill: `tokenomist-ai/tokenomist-burn-buyback` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tokenomist-ai/tokenomist-burn-buyback`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tokenomist-ai/tokenomist-burn-buyback/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tokenomist-ai (https://skillmd.com/u/tokenomist-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tokenomist-ai/tokenomist-burn-buyback

---


# 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:
```bash
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 |

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

Get burn events for a specific token:
```bash
tok burn detail <tokenId> --output json
```

Options:
| Option | Description |
|--------|-------------|
| `--start <date>` | Start date (YYYY-MM-DD) |
| `--end <date>` | End date (YYYY-MM-DD) |

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

### Buybacks

List all tokens with buybacks:
```bash
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 |

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

Get buyback events for a specific token:
```bash
tok buyback detail <tokenId> --output json
```

Options:
| Option | Description |
|--------|-------------|
| `--start <date>` | Start date (YYYY-MM-DD) |
| `--end <date>` | End date (YYYY-MM-DD) |

```bash
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.