| name | tokenomist-emission-report |
| description | Get daily or weekly token emission data with allocation breakdowns. Use when analyzing token inflation, comparing emission rates, or understanding supply increases. |
| 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: Emission Report
Get daily or weekly token emission data with allocation breakdowns.
When to use
When you need to analyze token inflation over time, compare emission rates across periods, or understand which allocations are contributing to supply increases.
Commands
Daily emission
tok emission daily <tokenId> --output json
Options:
| Option | Description |
|---|
--start <date> | Start date (YYYY-MM-DD) |
--end <date> | End date (YYYY-MM-DD) |
--standard-allocation <names> | Filter by allocation (comma-separated) |
--page <number> | Page number |
--page-size <number> | Items per page |
tok emission daily arbitrum --start 2024-08-01 --end 2024-08-31 --output json
tok emission daily arbitrum --standard-allocation "privateInvestors" --output json
Available --standard-allocation values: community, founderTeam, privateInvestors, publicInvestors, others, reserve (comma-separated for multiple).
Weekly emission
tok emission weekly <tokenId> --output json
Options:
| Option | Description |
|---|
--start <date> | Start date (YYYY-MM-DD) |
--end <date> | End date (YYYY-MM-DD) |
--standard-allocation <names> | Filter by allocation (comma-separated) |
--page <number> | Page number |
--page-size <number> | Items per page |
tok emission weekly arbitrum --start 2024-01-01 --end 2024-06-30 --output json
tok emission weekly arbitrum --standard-allocation "founderTeam" --output json
Key output fields
| Field | Description |
|---|
startDate | Period start |
endDate | Period end |
unlockAmount | Tokens emitted in period |
unlockValue | USD value of emitted tokens |
referencePrice | Token price used for value calculation |
allocations | Breakdown by allocation (name, amount, value) |
totalCumulativeUnlockedAmount | Running total of all unlocked tokens |
Analysis workflow
- Get weekly emissions to see the trend:
tok emission weekly <id> --output json
- Look at
unlockAmount over time to spot acceleration or deceleration
- Check
allocations to see if emissions are going to investors (sell pressure) vs community/ecosystem (growth)
- Compare
unlockValue against market cap from tok token list to assess dilution
Domain Context
- Emission data shows scheduled releases per allocation. Actual on-chain supply may differ due to relocks, delays, or early releases.
- Compare
unlockValue against market cap (from tok token list) to assess dilution impact.
- Emissions going to "Investor" or "Team" allocations typically represent higher sell pressure than "Community" or "Ecosystem" allocations.
Workflow
- Combine with
tok unlock events <id> to distinguish between cliff unlocks (large one-time events) and continuous emissions (steady daily/weekly releases).
- Chain with
tok burn detail <id> to calculate net inflation: emissions minus burns = net new supply.
- Use
tok allocation detail <id> to see the full allocation picture and understand where emissions are going.
