Token Vesting Calculator: Unlock Dates and Amounts
Map a token vesting schedule month by month. Enter the TGE unlock, cliff and vesting period to see every release date, the share unlocked so far and its value.
How to use this calculator
Take the inputs from the project’s own documentation, such as its tokenomics page or whitepaper. Allocations are usually listed per group (team, investors, ecosystem), so run one group at a time.
- Total allocation: the number of tokens in the group.
- TGE unlock: the share released at the token generation event, the moment the token is issued.
- Cliff: whole months after the TGE with no further releases.
- Cliff unlock: an optional one-off release when the cliff ends.
- Vesting period and frequency: how many months the rest takes to release after the cliff, and whether it arrives monthly or quarterly.
- Start date and price: the TGE date and, if you like, a hypothetical token price to value each release.
The table lists every release with its date, amount, running total and share of the allocation, and the chart draws the same schedule as steps. If terms like cliff and linear unlock are new, start with token vesting explained.
How it’s calculated
TGE amount = T × g Cliff amount = T × c (released at month C) Remaining = T − TGE amount − Cliff amount Releases n = V ÷ s, rounded up Per release = Remaining ÷ n (rounded down to 8 decimals) Release k at month C + min(k × s, V), for k = 1 to n Cumulative % = tokens released so far ÷ T × 100 Value = tokens × P
- T is the total allocation in tokens.
- g is the TGE unlock and c the cliff unlock, both as decimals.
- C is the cliff length and V the vesting period after it, in months.
- s is the gap between releases: 1 month (monthly) or 3 months (quarterly).
- n is the number of releases after the cliff.
- P is the optional token price in dollars.
The last release absorbs any rounding, so the schedule always adds up to exactly T. Dates step forward one calendar month at a time, and a schedule that starts on the 31st falls on the last day of shorter months.
Worked example
Suppose a hypothetical team allocation of 1,000,000 tokens with a 10% TGE unlock, a 12-month cliff, no cliff unlock and 24 months of monthly vesting, starting October 1, 2026, at a hypothetical price of $0.50.
- TGE amount = 1,000,000 × 0.10 = 100,000 tokens on Oct 1, 2026, worth $50,000.00.
- Months 1 to 12: nothing new unlocks, so the unlocked share stays at 10%.
- Remaining = 1,000,000 − 100,000 = 900,000 tokens, released in 24 steps of 900,000 ÷ 24 = 37,500 tokens ($18,750.00 each).
- Month 13 (Nov 1, 2027): the first release lifts the total to 137,500 tokens, or 13.75%.
- Month 24 (Oct 1, 2028): 100,000 + 12 × 37,500 = 550,000 tokens, or 55%.
- Month 36 (Oct 1, 2029): 1,000,000 tokens, or 100%. The allocation is fully vested.
Switch the frequency to quarterly and the same 900,000 tokens arrive in 8 releases of 112,500, the first on Jan 1, 2028 (month 15) and the last still on Oct 1, 2029.
Example: The steepest part of the chart shows when supply grows fastest. Comparing each release with the tokens already circulating shows how large it is relative to the current market, a point covered in circulating, total and max supply.
Limitations
- Real contracts differ. Some release tokens continuously as time passes rather than in monthly steps, and some accrue vesting from the start date and release everything accrued when the cliff ends. You can approximate the second pattern with the cliff unlock percentage.
- It models one allocation at a time. The full supply picture needs every group added together, which is also how fully diluted valuation differs from market cap.
- The token price is a single hypothetical number held constant, so the value column is not a forecast.
- Unlocked is not the same as sold, and schedules can be changed by governance votes or new agreements. Read the project’s current terms, including the fine print on airdrop allocations.
- Months are calendar months, so the number of days between releases varies slightly.
Frequently asked questions
What is a cliff in token vesting?
A cliff is a waiting period after launch during which no further tokens are released from an allocation. In the example on this page, a 12-month cliff means nothing unlocks between the token generation event and month 12, and monthly releases begin in month 13. Some schedules also release a lump sum when the cliff ends, which you can enter as the cliff unlock percentage.
What does TGE unlock mean?
TGE stands for token generation event, the moment a token is issued. The TGE unlock is the share of an allocation that becomes transferable at that moment, before any cliff or vesting applies. A 10% TGE unlock on 1,000,000 tokens makes 100,000 tokens available on day one, while the other 900,000 follow the rest of the schedule.
Does a token unlock mean the tokens will be sold?
No. An unlock only means the holder is able to move or sell the tokens. Some recipients hold them, stake them or lock them again, and others sell part of them. What an unlock does change is the supply that could reach the market, which is why holders often compare large upcoming releases with the number of tokens already in circulation.
What is the difference between linear and cliff vesting?
Cliff vesting releases nothing until a set date, then either a lump sum or the start of regular releases. Linear vesting releases equal amounts at regular intervals, such as every month, over a set period. Many token schedules combine the two, with a cliff first and linear releases after it, which is the pattern this calculator models.
Related guides
Sources
- What is Vesting in Crypto? Understanding Crypto Vesting Schedules — CoinGecko
- Token Generation Event (TGE) Definition — CoinMarketCap Academy
- Finance (VestingWallet) API reference — OpenZeppelin Docs
This content is for education only and is not financial, investment, tax or legal advice. Crypto assets are volatile and you can lose money. Examples use hypothetical numbers. See our disclaimer and editorial policy.