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

From Mechanics to Evaluation

The first three lessons in this module covered tokenomics mechanics: supply curves, vesting, burns, real yield, and the case studies that illustrate each. This lesson is different. It is about evaluation — about what to look for when a token launches, how to read a tokenomics whitepaper or pitch deck with a critical eye, and which numbers and structures matter most for predicting how a token will behave. Most retail investors read tokenomics like marketing copy: looking for the hook, skipping the details, anchoring on the headline. Sophisticated allocators read tokenomics like financial statements: looking for what the project is not telling you, comparing across projects, asking whether the design will actually produce the claimed outcomes. This lesson teaches the second mode of reading. The framework has eight components: supply structure, vesting schedule, allocation breakdown, red flags, value accrual mechanics, real yield ratio, inflation rate, and cross-project comparison. We close with a worked example contrasting Bitcoin's tokenomics (the canonical "fair launch") with a typical 2024-2026 L1 launch (large team and VC allocations, ongoing inflation). The point is not to canonize Bitcoin or pillory new launches, but to give you a vocabulary for distinguishing structurally sound designs from structurally questionable ones. A note on scope: this lesson covers token allocation and supply analysis. It does not cover the actual valuation question (is the token worth $X or $Y at current usage). Valuation analysis depends on the protocol's revenue, growth, and competition; it is covered in Module 10 (Protocol Analysis & Due Diligence). This lesson focuses on whether the tokenomics structure itself is sound — a necessary but not sufficient condition for the token being a good investment.

Also in this lesson

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.

Continue this lesson — 7 more sections in the CryptoBipto app.

Open lesson

Educational only — not financial advice.