DeCrypto Markets

Learn: tokens

What are token unlocks, and how do you read the calendar?

A token unlock is a scheduled release of tokens that were locked for a team, early investors, a treasury or an airdrop. An unlock calendar shows circulating supply month by month. Add up what each allocation releases next month; for the market cap to stay flat, the price must fall to price times old supply divided by new supply.

How it works

Most new tokens do not put their whole supply into circulation at launch. A share is sold or placed in a liquidity pool; the rest is locked and released later under a schedule. The schedule usually combines a cliff, a period with no release, and vesting, a release in equal monthly parts after the cliff.

Plotted month by month, the circulating supply rises in steps: flat during cliffs, a jump when a cliff ends, then a steady staircase while vesting runs. That staircase is the unlock calendar. Anyone can read it, which is why large unlocks are known in advance.

An unlock adds supply. Whether the price falls depends on demand, which nobody can schedule. But the arithmetic is fixed: market cap is price times circulating supply, so more supply at the same market cap means a lower price.

The exact rule the games grade by

The rule the game uses: month 0 is the launch. Before its cliff ends, an allocation has released only its launch (TGE) share. At the end of the cliff month any cliff share unlocks; linear vesting then releases an equal share of the rest every month, the first at cliff + 1, rounded down to whole tokens. Next month's supply = this month's supply + every release next month. The price that keeps the market cap flat = price x S0 / S1.

Step by step

  1. List the allocations with their cliffs and vesting lengths.
  2. Mark every allocation that releases tokens next month: cliffs that end, and vesting that is still running.
  3. Add those releases to this month's circulating supply to get next month's.
  4. Divide this month's supply by next month's and multiply by the price: that is the flat-cap price.
  5. Note the supply growth in percent, and how far the calendar still runs.

Worked example

An unlock calendar: circulating supply by monthCirculating supply of an invented token month by month, from launch to full unlock in month 36. Month 19 to 20 adds 20.39 million tokens, 7.06% more supply.0M125M250M375M500M061218243036Circulating VLW, millionsMonths after launchMonth 20: 309.19M
VLW: circulating supply by month, with month 20 marked.

The diagram shows the calendar of VLW, an invented token with 500 million tokens. It starts with only the public share circulating, stays flat while the cliffs run, then climbs in monthly steps until month 36, when the whole supply is out.

In month 19, 288.81 million tokens circulate and the price is 2.8482 USDT. Three allocations release tokens in month 20: the team, the airdrop and the investors. Together they add 20.39 million, so supply grows 7.06%, to 309.19 million.

Flat-cap price: 2.8482 x 288.81 / 309.19 = 2.6604 USDT. If the price stays above that, the market cap has grown; below it, it has shrunk. Neither tells you what the price will do.

Takeaway: An unlock calendar is public arithmetic. Month 20 adds 7.06% more supply, and only new demand keeps the price from diluting to 2.6604.

Common mistakes

  • Missing allocations that vest in parallel. Several allocations can release in the same month: a cliff ending for one while another keeps vesting. Count every line of the table, not just the biggest unlock.
  • Counting the first vesting month wrong. With linear vesting after a cliff, the first monthly release comes the month after the cliff ends. Off-by-one errors in the calendar are common.
  • Reading an unlock as a certain drop. An unlock adds supply; it does not force anyone to sell. Prices sometimes fall before or after unlocks, and sometimes do not. The flat-cap price is arithmetic, not a forecast.
  • Using percentages of the wrong base. An unlock of 2% of the maximum supply can be 10% or more of the circulating supply when the float is small. Measure growth against what circulates now.

What this does not tell you, and what can go wrong

The calendar shows supply, not demand. Large unlocks are known in advance, so markets may already reflect them, or not. Nothing on the calendar predicts the price.

Schedules are promises. Teams can change vesting, tokens held in treasuries may be spent faster or slower than shown, and some unlocked tokens are never sold. Real calendars are also messier than the game's clean monthly steps.

Supply can grow outside the calendar through staking rewards, emissions or a mint authority. See rug pulls for why a mint that is not renounced is a red flag.

Questions people ask

Do token unlocks always make the price fall?

No. An unlock adds supply, and if demand does not grow, the price that keeps the market cap flat is lower. But unlocked holders may not sell, and demand can change for many reasons. The flat-cap price is arithmetic, not a forecast.

How do I calculate next month's circulating supply?

Start from this month's circulating supply. For every allocation, add what it releases next month: a cliff share if its cliff ends, or one month of vesting if it is vesting. The total is next month's circulating supply.

What is the flat market cap price?

It is the price at which the market cap stays the same after supply grows: price x old supply / new supply. If supply grows 10%, the flat-cap price is about 9.1% lower. It shows how much new demand is needed to hold the price.

Where can I see a token's unlock schedule?

Projects usually publish an allocation table and vesting schedule in their documents, and some data sites collect them. Check the token contract and the vesting contracts where you can, because published schedules are statements by the issuer and can differ from what the contracts do.

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.

What it teaches