Skip to content
How to verify Projects

How to Read a Token Unlock Schedule and Check It On-Chain

Most tokens have more supply coming than is trading today, and the plan for releasing it is usually public. This guide shows how to read an unlock schedule - timing, size, recipients - and how to tell an enforced lock from a promise.

How to Read a Token Unlock Schedule and Check It On-Chain

For many tokens, most of the eventual supply does not trade yet. Allocations to the team, early investors, a treasury or ecosystem incentives are released over time, and the plan for that release is normally published. Reading it costs nothing and tells you more about the coming months than most commentary. This guide covers what a schedule says, how to size it, and how to check whether it is enforced.

What a Schedule Answers

An unlock schedule answers three questions: when tokens become transferable, how many, and to whom. The third is the one most often skipped, and it is the most useful. Allocations are grouped – team, investors, treasury, ecosystem, public sale – and the groups behave differently because they hold different incentives and different cost bases.

Cliffs and Vesting

A cliff releases nothing until a date and then a tranche at once. Vesting releases gradually, often monthly, after the cliff. The shape matters more than the total: two projects releasing the same share of supply over the same period look very different if one drips it evenly and the other releases it in a few large steps. Clustered cliffs create dates when a large quantity becomes transferable simultaneously, visible to anyone with a calendar. The glossary entry on vesting schedules sets out the terms.

Size It Against What Trades

An unlock is meaningful relative to what already circulates, not in isolation. A tranche equal to a small fraction of circulating supply is one situation; a tranche comparable to circulating supply is another. A second comparison is against traded volume: supply that is large relative to daily volume has a different character from supply the market could absorb in an hour. Both figures are public, and the ratio is the useful number. Our guide to verifying token supply on-chain shows how to get the denominators from the contract rather than a data site.

Why Recipients Matter

Different holders acquired their tokens at different prices. An early investor whose allocation was priced at a fraction of today’s market faces a simple decision at unlock. A team allocation faces the same arithmetic plus reputational and often contractual limits. A treasury allocation is usually spent over years to fund work. Ecosystem incentives exist to be distributed, and recipients often sell them quickly. None of this is an accusation; it is the reason a schedule that lists recipients is more informative than a single total.

Emissions Are a Schedule Too

Unlocks release tokens that already exist. Emissions create new ones, usually as rewards to validators or liquidity providers, and they arrive continuously rather than on cliff dates. Emissions are often missing from unlock calendars while being the larger source of new supply. Their rate is typically a protocol parameter that governance can change, so check where it is set and who can change it.

Enforced Lock or Stated Intention?

“Locked” can mean held by a contract nobody can override until a block or timestamp, or it can mean a commitment the holder could break. Both get the same word. The check is whether the lock is on-chain:

  1. Find the vesting or lock contract address in the project’s documentation.
  2. Open it on a block explorer and confirm the contract is verified; our guide to verifying smart contract source code explains what that badge means.
  3. Read the release schedule in the contract (cliff, duration, beneficiaries) and compare it with the published schedule.
  4. Check who can change it. If an admin can alter beneficiaries or timing, the lock is only as strong as that admin.

Where documentation does not distinguish, assume the weaker version until shown otherwise. Our existing check on token unlock schedule claims applies the same steps to a claim.

What a Schedule Does Not Tell You

An unlock makes tokens transferable; it does not mean they are sold. Assuming a mechanical price effect on each date is a stronger claim than the schedule supports, and an unlock everyone has known about for two years is not news on the day. Schedules can also be revised – vesting extended, investor terms renegotiated, emissions altered. The only fixed parameters are the ones the protocol enforces.

If no schedule is published at all, that is the finding. A project that will not say how much supply is coming, when or to whom has decided how much scrutiny it wants; treat unspecified future supply as unbounded rather than zero.

FAQ

Where do I find a schedule?

Project documentation, a tokenomics section or the original sale terms. Aggregator sites collect them, but transcription errors happen; use the primary source when a figure matters.

Does a big unlock mean the price will fall?

No. It means potential supply is arriving. What holders do with it is not in the schedule.

What is the single most useful check?

Whether the lock is enforced by a contract you can read, and who can change it.

Not financial advice.

About the author

The Crypto Online Editorial Team

A collective byline for a claim-verification desk. Every piece is human-edited and checked against a primary record; AI assistance is disclosed in our editorial guidelines.

All work by the team → Methodology Corrections

Not financial advice. Human-edited; AI-assisted drafting is disclosed in our editorial guidelines. Spotted an error? See how corrections work.