Token unlocks explained starts with a distinction between a contractual right and a completed market sale. A vesting schedule can make tokens available to a beneficiary over time. It does not prove that the beneficiary claimed, transferred or sold every newly available token.
Reading an unlock calendar therefore requires more than a date and a percentage. Check the allocation, schedule, contract and denominator used in any supply calculation before interpreting the event.
Allocation, Vesting and Release Are Different Steps
An allocation describes an amount assigned under a project’s arrangements. Vesting defines when rights accrue or assets become eligible for release under the relevant terms. Claiming or releasing tokens can require an additional contract action. A transfer to an exchange is another step, and an executed sale is another again.
Crypto token vesting explained this way avoids turning every allocation entry into immediate circulating supply. The project’s definitions and on-chain implementation must be examined together. A calendar entry is a summary of those arrangements, not a replacement for them.
Cost of Mistiming Crypto Trades
Cliff Vesting vs Linear Vesting
| Feature | Meaning | What to check |
|---|---|---|
| Cliff | A period before any release becomes available | Whether accrued vesting catches up at the cliff |
| Linear schedule | Availability grows according to a time-based rule | Start, duration, rounding and release conditions |
| Stepped schedule | Availability changes in discrete tranches | Exact dates, amounts and any conditions |
| Claim action | An eligible beneficiary requests release | Whether the calendar counts eligibility or actual claims |
OpenZeppelin’s vesting-wallet documentation illustrates that schedule behaviour belongs to the contract implementation. A label such as “one-year cliff” does not tell you every rule. For example, the arrangement may accrue from an earlier start date or may begin accrual only after the cliff.
Also distinguish a continuous linear release from a calendar displaying monthly checkpoints. Two presentations can summarise the same accrual curve, while two contracts with similar labels can implement different release conditions.
A Worked Vesting Example
Assume a hypothetical grant of 1.2 million tokens vests linearly over 48 months from its start date, with no release permitted before month 12. Under this explicitly defined catch-up arrangement, 300,000 tokens would be vested at month 12, followed by 25,000 tokens per month over the remaining period.
This is an illustrative schedule, not the behaviour of every vesting contract. A different arrangement could release nothing for 12 months and then begin a new 48-month vesting period. Read the actual start, cliff and duration definitions.
To show an unlock as a percentage, identify the denominator. A 300,000-token event is 0.3% of a 100-million total supply but 3% of a 10-million circulating supply. Those percentages answer different questions.
Circulating Supply vs Unlocked Tokens
An unlocked token may remain in a beneficiary’s wallet, be subject to another restriction or not yet have been claimed. Data providers may use different circulating-supply definitions. Document the method before comparing calendars that appear to disagree.
An incident involving a hacked crypto account in Singapore also changes the practical review: the intended recipient and control over the receiving address must be established. Vesting eligibility does not establish that the right person still controls the release destination.
Being transferable does not mean being accepted for ordinary purchases. If you plan to spend crypto in Singapore, check the supported asset, network and merchant terms separately. An unlock event is not evidence of payment acceptance.
How to Read a Token Vesting Schedule
- Find the project’s allocation and vesting documentation through verified channels.
- Identify the beneficiary group and the exact token contract.
- Record the start date, cliff, duration and release method.
- Check whether the calendar shows eligibility, claims or estimated circulating supply.
- Confirm the denominator used for percentages.
- Compare the documentation with the deployed contract and relevant transactions.
A contract address alone is not enough if the schedule is implemented through several contracts, an administrator or an upgradeable system. Record who can change the relevant arrangements and how changes are disclosed.
What an Unlock Calendar Cannot Predict
An unlock schedule does not reveal every beneficiary’s intention, the eventual sale size or the price at which an order might execute. Market liquidity, other supply changes and demand all matter. Treat a statement that an unlock “must crash the price” as a claim requiring evidence.
Likewise, an absence of a large scheduled release does not mean there is no selling pressure. Already-circulating holders can trade, and a calendar may have incomplete information. A documented supply event is one part of analysis rather than a complete trading signal.
Preserve the version of the documentation and the time of your observation. If a release date or allocation changes, you need a way to distinguish updated terms from an error in a third-party calendar.
Green Capstead: Check the Relevant Service Terms
If Green Capstead highlights an unlock event, request the underlying project documentation rather than treating the highlight as proof of an imminent sale. Check the asset and instrument actually offered, and distinguish a trading-service observation from control over the project’s vesting contract.
FAQ
Does unlocked mean sold?
No. Eligibility, claiming, transfer and sale are different events. Look for the relevant evidence rather than treating the calendar as a trade record.
Does a cliff always release a lump sum?
No. The result depends on how accrual and the cliff are defined. Read the implemented schedule and agreement.
Why do two calendars show different unlock percentages?
They may use different supply denominators, data versions or definitions of eligibility and circulation. Compare the underlying method.
Can a token unlock guarantee a price fall?
No. The event does not establish actual sales or the market’s response. A price claim needs a separate analysis.
Conclusion
A token unlock schedule is most useful when the underlying terms can be checked. Separate allocation, vesting, release and sale; state the supply denominator; and keep the document version. That approach turns a calendar entry into a traceable fact without overstating what it predicts.
Sources
- OpenZeppelin Contracts Documentation — VestingWallet
- OpenZeppelin Contracts Documentation — VestingWalletCliff
- OpenZeppelin Documentation — Linear and Stepped Vesting Wallets