token-economics
Token supply dynamics, vesting analysis, inflation modeling, and valuation frameworks for crypto tokens
By agiprolabs · 348 installs
npx skills add agiprolabs/claude-trading-skills --skill token-economics
Source repository · Upstream listing
Token Economics
Tokenomics — the study of token supply dynamics, distribution, and value accrual — is one of the most important factors in crypto asset analysis. Supply changes directly affect price: new tokens entering circulation create selling pressure, while burns and locks reduce it. Understanding these dynamics lets you estimate dilution risk, identify overvalued or undervalued tokens, and anticipate price moving unlock events.
Why Tokenomics Matters
Price is a function of demand and supply. In crypto, supply is programmable and constantly changing:
A token inflating at 50%/year needs 50% demand growth just to maintain price
A large unlock releasing 10% of circulating supply in one day often causes 5 20% drawdowns
Tokens with 80% of supply locked have extreme dilution risk ahead
Protocols that burn fees can become net deflationary, creating structural price support
Key Supply Concepts
Total Supply vs Circulating Supply
Market Cap vs Fully Diluted Valuation
The FDV/MCap ratio measures future dilution risk:
FDV/MCap Dilution Risk Interpretation
1.0 1.5 Low Most supply already circulating
1.5 3.0 Moderate Significant supply still locked
3.0 5.0 High Majority of supply not yet released
5.0 Very High Token will face massive dilution
Net Inflation Rate
Supply Dynamics
Inflationary Pressure (tokens entering circulation)
Emissions : Block rewards, liquidity mining, staking rewards
Vesting unlocks : Team, investor, and advisor tokens unlocking on schedule
Unlock events : Large one time releases (cliff expirations)
Treasury spending : DAO or foundation distributing tokens
Deflationary Pressure (tokens leaving circulation)
Fee burns : Protocol burns a portion of transaction fees (like EIP 1559)
Buyback and burn : Protocol uses revenue to buy and permanently destroy tokens
Staking locks : Tokens locked in staking (temporarily removed from circulation)
Lost tokens : Permanently inaccessible tokens (lost keys, burn addresses)
Selling Pressure Estimation
Vesting and Unlock Schedules
Key Concepts
Cliff : Period before any tokens unlock (typically 6 12 months)
Linear vesting : Constant rate of unlock after cliff (monthly or daily)
Stepped vesting : Periodic unlocks at set intervals (quarterly)
TGE unlock : Percentage released at Token Generation Event
Analyzing Unlock Impact
Tracking Sources
CoinGecko / CoinMarketCap : Basic supply data
Token Terminal : Revenue and valuation metrics
Token Unlocks (token.unlocks.app) : Detailed unlock schedules
Project documentation : Whitepapers, tokenomics pages
On chain : Vesting contract state, treasury balances
Token Distribution Analysis
Typical Allocation Ranges
Category Typical Range Red Flag
Team/Founders 15 25% 30%
Investors (Seed+Series) 10 30% 40%
Community/Ecosystem 20 40% <15%
Treasury/DAO 10 20% <5%
Public Sale 5 20% <2%
Advisors 2 5% 10%
Distribution Red Flags
50% insider allocation (team + investors): Insiders control price
Short vesting (<1 year): Quick dump risk
No cliff : Immediate selling from day one
Large single wallets : Concentration risk (use token holder analysis skill)
Unlabeled large allocations : Hidden insider holdings
Distribution Quality Score
Valuation Frameworks
Revenue Based Metrics
Typical ranges (crypto, highly variable):
P/E: 10x 100x+ (DeFi protocols)
P/S: 0.5x 50x
P/F: 20x 500x
Network Value Metrics
Comparable Analysis
Token Value Accrual Mechanisms
Mechanism Description Valuation Impact
Fee sharing Holders receive protocol revenue Direct cash flow, use DCF
Governance Voting rights on protocol Hard to value, often overpriced
Utility Required for protocol use Demand scales with usage
Buyback & burn Protocol buys and burns Reduces supply, structural bid
Staking rewards Yield from staking Inflationary if from emissions
veToken model Lock for boosted rewards + governance Reduces circulating supply
PumpFun Token Economics
PumpFun tokens on Solana have simplified tokenomics:
Fixed supply : 1,000,000,000 tokens (1 billion)
No vesting : All tokens available immediately at launch
No team allocation : 100% available on bonding curve
Bonding curve pricing : Price determined by curve math, not supply changes
Post graduation : After bonding curve completes, supply is fully liquid on Raydium
No inflation : No emissions, no staking rewards, no additional minting
Analysis focus for PumpFun tokens shifts from supply dynamics to:
Holder concentration (use token holder analysis )
Volume sustainability
Liquidity depth (use liquidity analysis )
Dev wallet behavior
Integration with Other Skills
Skill Integration
defillama api Fetch TVL, revenue, fees for valuation metrics
token holder analysis Analyze holder concentration and whale behavior
coingecko api Fetch supply data, market cap, FDV
liquidity analysis Assess trading liquidity relative to supply
risk management Supply dilution as risk factor
position sizing Adjust size for dilution risk
Files
References
references/supply analysis.md — Circulating supply tracking, inflation modeling, unlock analysis, burn mechanics
references/valuation frameworks.md — Revenue based valuation, NVT, MVRV, comparable analysis, value accrual
Scripts
scripts/tokenomics analyzer.py — Fetch and analyze token supply metrics from CoinGecko, calculate dilution risk and basic valuations
scripts/supply modeler.py — Project token supply over 12 months given emission and burn parameters, scenario analysis