tokenomist-emission-report

Get daily or weekly token emission data with allocation breakdowns. Use when analyzing token inflation, comparing emission rates, or understanding supply increases.

SKILL.md

GitHub

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

  1. Get weekly emissions to see the trend: tok emission weekly <id> --output json
  2. Look at unlockAmount over time to spot acceleration or deceleration
  3. Check allocations to see if emissions are going to investors (sell pressure) vs community/ecosystem (growth)
  4. 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.