A token unlock calendar looks like a countdown, but a calendar date is the least informative thing about it. Vesting is really a chain of separate events — a token becomes vested, then claimable, then transferable, then maybe sold — and most unlock reporting collapses all four into a single number. Reading a schedule well means keeping those stages apart.
Vesting is the rule that decides when a beneficiary earns access to an allocation. Founders, employees, investors, advisers, treasuries and community programs all receive tokens on schedules designed to stop an entire insider allocation from becoming liquid on day one. A cliff is an initial period during which nothing can be claimed, or during which accrued vesting cannot be claimed, depending on the contract. An unlock merely ends a restriction for a quantity of tokens; it does not prove the recipient will move anything to an exchange.
The reference implementation exposes the details that marketing charts hide. OpenZeppelin’s VestingWallet is an ownable contract that holds native currency and ERC-20 tokens and releases them to a beneficiary on a schedule. Three behaviours deserve attention. Assets deposited after vesting has already started are treated as if they were locked from the beginning, so part of them may be immediately releasable. Because the wallet is ownable, the claim itself can be transferred, so a promise that insiders cannot sell may still leave the unvested position sellable. And integrators are told to account for rebase tokens, whose balances adjust automatically and would otherwise skew the intended vested amount.
Standardization is still two competing designs. ERC-5725 is finalized and extends ERC-721 into transferable vesting NFTs that release an underlying token over a vesting curve. ERC-7720, still a draft, does the opposite: it records an ERC-20 deposit that a beneficiary can withdraw only after a set future timestamp, tracking each deposit separately. One makes the locked right tradable; the other keeps the deposit fixed and merely time-gates withdrawal. A project’s published schedule is not meaningful until you know which pattern it actually shipped.
Four questions size an unlock’s risk. Size the event as a percentage of current circulating supply, not an absolute count. Name the recipient bucket, because team, investor, foundation and market-maker allocations behave differently. Compare the possible flow with real liquidity, not headline 24-hour volume, which is not executable depth. And check flexibility: whether governance or an administrator can postpone, accelerate, redirect, burn, stake or relock supply changes what every date on the calendar means.
The classic mistakes are all category errors. A cliff does not mean nothing has vested, since vesting can accrue while claims stay blocked and produce a large first release. A five percent unlock does not become a five percent price drop. Circulating supply is a provider’s definition, not a physical fact. A transfer out of a vesting wallet proves movement, not a sale. Reading the schedule with those distinctions intact turns a meme-able countdown into something an investor can actually verify against the contract.
Adapted from Token Vesting Explained: Cliffs, Unlocks, and Supply Risk.