Learn: tokens
What is tokenomics, and how do you read it?
Tokenomics is the design of a token's supply: how many tokens can ever exist, who receives them, and when they are released. An allocation table splits the supply between groups such as the public, the team and early investors, with cliffs and vesting schedules. As locked tokens are released, circulating supply grows and each holder's share is diluted.
How it works
Every token starts with a supply plan. Some tokens are sold or placed in a liquidity pool at launch and circulate immediately. Others go to the team, early investors, an ecosystem fund, a treasury or an airdrop, and are locked for a while. The plan is usually published as an allocation table: each group, its share of the supply, what it receives at launch, its cliff and its vesting.
A cliff is a waiting period with no release. Vesting is the release that follows, often linear: an equal share every month until the allocation is fully unlocked. The sum of everything released so far is the circulating supply. Its growth over time is the unlock calendar.
Why it matters: market cap is price times circulating supply. If supply grows and demand does not, the price that keeps the market cap flat falls. Insiders who received tokens cheaply may also sell when their tokens unlock. None of this predicts a price, but it tells you how much supply is still to come and who holds it.
The exact rule the games grade by
The rule the game uses: month 0 is the launch. An allocation releases its launch (TGE) share at once; before its cliff ends, that is all. At the end of the cliff month any cliff share unlocks, and linear vesting then releases an equal share of the rest every month, first at cliff + 1, until it is fully unlocked. unlocked(m) = TGE part + cliff part + rest x min(1, (m - cliff) / vest), in whole tokens, rounded down. Circulating supply is the sum over all allocations. Market cap = price x circulating supply; FDV = price x maximum supply.
Step by step
- Read the maximum supply and each allocation's share of it.
- For each allocation, note what it released at launch, the cliff in months and the vesting length.
- Add up what every allocation has released by the month you care about: that is circulating supply.
- Compare circulating supply with the maximum: the gap is supply still to come.
- Ask who holds the locked part, and when it unlocks.
Worked example
The diagram shows the allocation table of VLW, an invented token with a maximum supply of 500 million. The public sale and liquidity hold 12% and circulated at launch. The team holds 29% with a 12-month cliff and 18 months of vesting. Early investors hold 29%, with a 12-month cliff and 24 months of vesting. The airdrop holds 30%, with a 6-month cliff and 18 months of vesting.
In month 19, 288.81 million tokens circulate: 57.8% of the maximum. At a price of 2.8482 USDT the market cap is 822.58 million USDT, while the fully diluted value is 1,424.10 million.
In month 20, the team, the airdrop and the investors all release tokens: 20.39 million more, so circulating supply grows 7.06% to 309.19 million. To keep the market cap flat, the price would have to fall to 2.6604 USDT. The supply is fully unlocked in month 36.
Takeaway: Read who holds the supply and when it unlocks. At 57.8% circulating, most of the dilution of VLW is still ahead.
Common mistakes
- Looking only at the price. A low price per token says nothing on its own. What matters is price times supply, both circulating and maximum, and how fast the circulating part grows.
- Ignoring insider allocations. Team and investor tokens are often bought at a fraction of the public price. When they unlock, those holders can sell at a large profit even if the price has fallen.
- Trusting the table blindly. An allocation table is a statement by the issuer. Check what the token contract actually allows, for example whether a mint authority can create more supply than the table shows.
- Treating emissions as free money. Tokens paid out as rewards are new supply. They dilute holders just like an unlock. See APY vs APR for how emissions inflate yields.
What this does not tell you, and what can go wrong
Tokenomics describes supply, not demand. A token with a tidy schedule can still go to zero, and one with heavy unlocks can rise for a while if demand grows faster. Nothing in an allocation table predicts a price, and most crypto tokens have failed regardless of their design.
Published schedules can change. Teams can extend or shorten vesting, governance can vote new emissions, and some contracts allow minting beyond the stated maximum. The table is a promise; the contract is what actually runs.
The game uses an invented token with exact, simple schedules. Real schedules can be irregular, partly off-chain, or hard to verify.
Questions people ask
What does a cliff mean in token vesting?
A cliff is a period after launch during which an allocation releases nothing. When the cliff ends, any cliff share unlocks at once, and then vesting usually releases the rest in equal monthly parts. A 12-month cliff with 24 months of vesting means nothing for a year, then releases over the following two years.
What is circulating supply?
Circulating supply is the number of tokens that have been released and can be traded. It is smaller than the maximum supply when some tokens are still locked. Market cap uses circulating supply, which is why a token can look smaller than its fully diluted value suggests.
Why do token unlocks matter to holders?
Each unlock adds supply. If demand does not grow with it, the price that keeps the market cap flat falls, so existing holders own a smaller share. Unlocks to insiders can also add selling, because those holders often paid far less than the public. This is a reason to ask questions, not a price forecast.
Is good tokenomics a reason to buy a token?
No. Tokenomics only describes how supply is created and released. It says nothing about whether anyone will want the token, whether the contract is safe, or whether the project survives. Most crypto tokens have failed, including many with careful supply plans.
Practise it
Reading about a rule is not the same as applying it. These games generate a fresh simulation each round, ask you to make the call first, and grade you against the same rule.
Tokenomics
Market cap, FDV and an unlock calendar. Work out next month's supply and the price that keeps the cap flat.