Crypto Token Unlocks and Vesting: How to Measure the Real Supply Event

Key takeaway: A token unlock is not the same as new circulating supply, and new circulating supply is not the same as selling. Analyze five separate stages: scheduled vesting, on-chain claimability, transferability, provider classification as circulating, and observed transfers to market venues. Measure the event against current circulation and executable liquidity, then document a range instead of assuming every unlocked token is sold.

What is a crypto token unlock?

A crypto token unlock is the point at which tokens subject to a time, milestone, contract, or legal restriction become claimable or transferable under the applicable schedule. The exact event depends on the implementation.

Avalanche’s builder documentation describes the common components: total allocation, cliff, vesting period, and release interval, with linear, graded, and cliff-based schedules among the possible designs (Avalanche Builder Hub).

An unlock can mean:

• Tokens automatically transfer to a beneficiary
• A beneficiary becomes able to claim vested tokens
• A contractual restriction expires while tokens were always on-chain
• A timelock releases control of a treasury allocation
• A milestone makes a tranche eligible, subject to another action

Never rely on the word “unlock” without identifying which mechanism applies.

Scope and assumptions: This guide covers fungible-token vesting and scheduled distribution. It does not interpret employment agreements, SAFTs, securities law, tax obligations, or private side letters. Where the on-chain implementation and legal agreement differ, both may matter.

BlockMind provides research, not financial advice. Its agent will not tell you what to buy or sell and cannot trade, withdraw, or move funds.

Unlock analysis is one part of the complete pre-buy crypto due diligence process, not a standalone signal.

The five stages most unlock calendars collapse

1. Scheduled to vest

The published schedule says some amount should become vested on a date or over an interval.

2. Claimable or releasable on-chain

The contract calculates an amount the beneficiary may release. A schedule may vest continuously while claims happen irregularly.

OpenZeppelin’s VestingWallet illustrates this distinction with separate concepts for vested, released, and releasable amounts. It also notes that ownership of an ownable vesting wallet may be transferable, making economic control more complex than a static beneficiary label (OpenZeppelin).

3. Transferable

The beneficiary can move the tokens. Transferability can begin at vesting, after claiming, or after another restriction expires.

4. Classified as circulating

A market-data provider may add some or all unlocked tokens to its circulating-supply estimate according to its methodology. That classification can lag the on-chain event or exclude certain controlled allocations.

5. Transferred to a market venue or counterparty

On-chain data may show a transfer to a labeled exchange, market maker, OTC counterparty, DeFi pool, custodian, or another wallet. This is evidence of movement, not definitive evidence of a sale. Exchange labels can also be incomplete or wrong.

The chain of inference should therefore be:

Scheduled → vested → claimable → claimed → transferable → moved → possibly sold

Skipping steps turns a public schedule into a false claim about holder intent.

How do cliff, linear, and step vesting work?

Cliff vesting

Nothing vests before a specified time; a tranche or the full allocation vests at the cliff.

Vested(t) = 0, for t < cliff
Vested(t) = allocation or scheduled tranche, for t ≥ cliff

Check whether vesting accrues during the cliff and becomes available at once, or begins only after the cliff. Both patterns exist.

Linear vesting

For allocation A, vesting start t0, and duration D:

Vested(t) = 0                              if t < t0
Vested(t) = A × (t − t0) / D              if t0 ≤ t < t0 + D
Vested(t) = A                              if t ≥ t0 + D

Rounding and timestamp units matter in code. A front end may display monthly unlocks while the contract accrues every second.

Cliff plus linear vesting

A common implementation returns zero before the cliff, then applies a linear schedule. Confirm whether the amount accrued since t0 becomes available at the cliff or the line begins there.

Step or graded vesting

Tokens vest in discrete tranches:

Vested(t) = allocation per step × completed steps

The schedule might be monthly, quarterly, milestone-based, or irregular.

Emissions are not always vesting

Validator or liquidity incentives can be created and distributed according to protocol activity rather than a beneficiary’s locked allocation. Include them in net supply analysis, but label them separately.

The token unlock verification protocol

Step 1: locate the canonical schedule

Use this evidence order:

1. Verified vesting or timelock contract
2. Current official tokenomics or transparency disclosure
3. Executed governance proposal
4. Signed allocation agreement, if public
5. Third-party calendar that links to a primary source

Archive the source and record its publication or revision date. Historical schedules can be superseded.

The Solana Foundation’s historical transparency report, for example, separated founders, investors, validators, employees, community allocations, and market-making arrangements, with different timing and restrictions (Solana Foundation). The lesson is not to reuse those old figures today; it is to preserve recipient-specific detail rather than quote one aggregate unlock number.

Step 2: reconcile schedule and contract

Capture:

• Chain and token contract address
• Vesting contract address
• Beneficiary or beneficiary class
• Total allocation deposited
• Start, cliff, duration, and cadence
• Released amount
• Releasable amount at the research timestamp
• Owner, admin, and upgradeability
• Revocation, acceleration, or transfer rights

If the paper says monthly vesting but the contract is a simple timelock, write the discrepancy. Do not assume the prose overrides deployed logic.

Step 3: normalize into time buckets

For each recipient class, calculate expected gross unlocks in 30-, 90-, 180-, and 365-day windows.

Gross scheduled unlocks = sum of all tranches in the window
Net scheduled supply change = unlocks + emissions − burns

Keep contract-verified values separate from estimates.

Step 4: measure the event with three denominators

Unlock / current circulation = tokens unlocked / circulating supply
Unlock / current unlocked supply = tokens unlocked / unlocked supply
Unlock notional = tokens unlocked × reference price

The notional figure is a scenario at the reference price, not predicted sale proceeds. The first ratio is often more interpretable because it shows how large the tranche is relative to the float the market already sees.

Step 5: compare with liquidity and recipient behavior

Measure:

• Order-book depth at standard price distances
• DEX price impact at relevant sizes
• Median credible spot volume, with methodology
• Recipient transfers after previous releases
• Known delegation, staking, treasury, market-making, or grant use

Use Crypto Liquidity Analysis for the market-capacity side and Whale Wallets and Exchange Flows for label and attribution limits.

The unlock-impact worksheet

Add three scenarios:

Do not assign probabilities unless you have a defensible model and enough comparable observations.

Worked hypothetical: the “Orchid” cliff

This example is fictional and not a forecast, recommendation, or observation about any real token.

Orchid has:

• 250 million circulating tokens
• A maximum supply of 1 billion
• A 40 million investor-token cliff in 30 days
• A reference price of $1.50
• Reported median daily spot volume of $18 million

Headline calculations:

Unlock / circulation = 40m / 250m = 16%
Reference-price notional = 40m × $1.50 = $60m

It would be wrong to conclude “$60 million of selling is coming.” Verification finds:

• The contract vests 40 million at the cliff but requires individual claims.
• The vesting-wallet owners can transfer ownership before the cliff.
• Ten million tokens belong to a strategic partner with a public staking commitment, but the commitment is not enforced by the vesting contract.
• Previous quarterly claims ranged from 20% to 65% of the available tranche during the first week.
• A $500,000 simulated sell quote produces materially different impact across the two largest venues.

The responsible output is a range:

A tranche equal to 16% of current reported circulation becomes claimable. The immediate market-available amount is uncertain because claims are discretionary and one staking commitment is not contract-enforced. Monitor claims, recipient wallets, provider circulation updates, and standardized liquidity tests; do not equate the $60 million notional with expected sale volume.

That conclusion distinguishes known mechanics from unknown behavior.

How to read unlock behavior after the event

Check at consistent intervals: event time, +24 hours, +7 days, and +30 days.

Record:

• Amount newly releasable
• Amount claimed or released
• Destination wallets
• Transfers to known contracts, staking, governance, bridges, custodians, or exchange clusters
• Changes in provider-reported circulating supply
• Changes in depth, spread, and price impact
• Relevant market-wide movement

Avoid post hoc causality. Price can move around an unlock because of the broader market, anticipation before the event, hedging, unrelated news, or liquidity conditions. “Price fell after unlock” does not prove unlocked recipients sold.

Token unlock red flags

• The schedule has no primary source
• Percentages do not reconcile with the stated supply
• Dates appear only in an image with no revision history
• “Locked” tokens sit in a normal transferable wallet
• Beneficiary or vesting-contract ownership can be transferred but is described as non-transferable
• Admin can accelerate, revoke, replace, or upgrade the schedule without a delay
• The calendar omits emissions, treasury distributions, or market-maker allocations
• Unlocks are quoted against maximum supply to make a near-term event look smaller
• Third-party calendars disagree and none links to current contracts
• A provider updates circulation without explaining the classification

How unlocks connect to market cap and FDV

Unlocks are the time dimension missing from the Market Cap vs FDV ratio.

Two assets can have the same circulation ratio but different risk profiles:

• Asset A releases the gap over 20 years to validators.
• Asset B releases half of the gap to early investors next quarter.

FDV sees the same denominator problem. The unlock schedule reveals timing and recipient concentration. Tokenomics research adds utility, emissions, and demand.

Limitations and counterevidence

• Legal restrictions or side letters may not be visible on-chain.
• Beneficiaries can use custodians or OTC counterparties that obscure final disposition.
• Entity labels and circulating-supply classifications can be incomplete.
• Wallet transfers do not reveal intent or prove a sale.
• Prior behavior is not a guarantee of future behavior.
• Governance can amend schedules.
• Price and liquidity can change before the event, making old notional comparisons stale.

The correct response is timestamped uncertainty, not invented precision.

Monitoring an unlock with BlockMind

A BlockMind agent can research current disclosures, inspect public contract and wallet pages through its browser capability, use on-chain intelligence to review flows and holders, and save the event assumptions in your Notebook. You can ask it to monitor a named condition, while keeping the interpretation under human control.

Example request:

“Verify the next [token] unlock from primary sources. Separate scheduled, releasable, claimed, transferable, and provider-circulating amounts. Calculate its share of current circulation, test current liquidity at three sizes, identify every assumption, and set a review for the event plus 24 hours and seven days.”

Always verify AI-generated crypto analysis against the decisive sources.

The Bottom Line

An unlock is a change in rights or contract state, not automatic selling. Verify the canonical schedule and live contract, normalize events into time buckets, compare them with current circulation and liquidity, identify recipient incentives, and observe what actually happens after release.

The most honest unlock analysis is a chain of evidence with explicit gaps: scheduled, vested, claimable, claimed, transferable, moved, and only then possibly sold.

Sources

• Avalanche Builder Hub — Vesting Schedules
• OpenZeppelin — VestingWallet
• OpenZeppelin — Cairo Finance and Vesting Schedules
• Solana Foundation — Historical Transparency Reports and Unlock Schedule
• CoinMarketCap — Market Capitalization Methodology