Reading a Tokenomics Document Like a Pro
A practitioner-grade framework for evaluating any project's tokenomics: total vs circulating supply, FDV ratios, vesting cliffs, allocation analysis, red flags, real-yield ratio, and a worked Bitcoin vs typical L1 contrast.
25 min · expert · part of Tokenomics: The Science of Token Design
What you'll learn
- From Mechanics to Evaluation
- Total Supply, Circulating Supply, and Fully Diluted Valuation
- Vesting Cliffs, Unlock Schedules, and How to Read Them
- Allocation Breakdown: Team, Investors, Ecosystem, Community, Treasury
- Value Accrual: Substantive vs Window Dressing
- Real Yield Ratio and Inflation Rate Calculation
- Worked Example: Bitcoin vs a Typical L1 Launch
- For Deeper Reading
Key terms
- Total Supply (Maximum Supply)
- The hard cap on the number of tokens that will ever exist. Bitcoin: 21M. Most modern L1s and DeFi tokens have a fixed maximum supply set in the genesis contract.
- Circulating Supply
- Tokens currently in circulation — held by addresses that can freely sell. Excludes tokens locked in vesting contracts, treasury reserves, and ecosystem programs that have not yet vested.
- Fully Diluted Valuation (FDV)
- Token price × total supply. The truer measure of how the market values the network long-term, assuming all tokens eventually circulate. Compare to market cap (price × circulating supply) to assess unlock pressure.
- Market Cap / FDV Ratio
- Underappreciated tokenomics signal. Above 50% = most supply already circulating. Below 20% = high inflation pressure ahead. Many 2024-2025 high-FDV/low-float launches saw 70-90% declines over the unlock period.
- Vesting Cliff
- Initial period during which no tokens unlock. After the cliff, tokens unlock either linearly over a vesting period or in scheduled tranches. Typical 2024-2026 structure: 6-12 month cliff + 24-48 months linear unlock.
- TokenUnlocks.app and Token Terminal
- The standard unlock calendar tools. TokenUnlocks.app for project-specific schedules; Token Terminal for aggregated tokenomics data including fee revenue and real yield. Use to verify project-published tokenomics.
- Allocation Categories
- How total supply is distributed: team, investors, advisors, public sale, ecosystem/community, treasury/DAO, liquidity, airdrops. Different categories have different incentives and selling propensities.
- Real Yield Ratio
- Of the yield a token holder earns, what percentage comes from actual fee revenue versus token emission. Above 70% = mostly self-sustaining. Below 30% = yield is mostly subsidy and will collapse if emissions reduce.
- Inflation Rate
- Percentage of supply added to circulation per year, including emissions and unlocks from cliffs. Below 2% = very low. Above 30% = very high. High-FDV/low-float launches can effectively inflate 50-200% in early years.
- Buyback and Burn
- Substantive value accrual: protocol uses real fee revenue to buy tokens off the market and destroy them. BNB Auto-Burn is canonical. Distinguish from cosmetic burns of unallocated treasury that do not change circulating supply.
- Substantive vs Cosmetic Mechanics
- Substantive: real fees flow to holders; buybacks funded by revenue; required protocol utility. Cosmetic: treasury-funded buybacks that move supply between wallets; burns of unallocated supply; staking yields funded entirely by inflation.
- Bitcoin Tokenomics Baseline
- No team allocation, no investor allocation, no treasury, no DAO, fixed 21M supply, no vesting (mining schedule only), ~0.85% annual inflation post-2024 halving. The structural benchmark for "fair launch" allocation against which all other launches can be contrasted.
Read the full lesson in the CryptoBipto app.
Open lessonEducational only — not financial advice.
