TL;DR

A token unlock calendar is a chronological schedule of every event that releases locked tokens into circulation. It includes TGE unlocks, cliff-end releases, and ongoing vesting distributions. Large unlock events, especially those releasing more than 5% of total supply at once, create significant sell pressure and are closely watched by traders and investors. Building and publishing a transparent unlock calendar is both a best practice for project teams and an essential research tool for anyone evaluating a token.

How It Works

When a token launches, only a fraction of its total supply is immediately available to trade. The rest is locked behind vesting schedules, cliff periods, and emission timelines. A token unlock calendar maps every event that releases locked tokens into circulation, creating a forward-looking timeline of supply increases.

Types of Unlock Events

Token unlock events fall into three categories, each with different market dynamics:

TGE unlocks happen at the moment of Token Generation Event (launch). Any allocation category with a non-zero TGE unlock percentage releases that portion immediately. These tokens are available to trade from the first block. TGE unlocks are the most scrutinized because they define the initial circulating supply and set the floor for day-one sell pressure.

Cliff-end unlocks occur when a category’s cliff period expires. If a team allocation has a 12-month cliff, zero additional team tokens enter circulation for the first 12 months after TGE (beyond any TGE unlock). On month 12, the cliff ends and the first batch of vesting tokens becomes available. Cliff-end events create sudden, one-time supply jumps that can be significant — a team allocation of 18% with a 12-month cliff and monthly vesting releases approximately 0.5% of total supply on the cliff-end date.

Vesting releases are the ongoing distribution of tokens after a cliff ends. Depending on the vesting curve, these happen continuously (linear), monthly (step vesting), or quarterly (quarterly steps). Linear vesting produces the smoothest supply increase, while quarterly vesting creates periodic lumpy events every three months.

Why the Calendar Matters

Unlock calendars serve different audiences for different reasons:

For traders, unlock events represent known supply shocks. A 5% supply unlock is equivalent to injecting a large sell order into the market. Traders use calendars to anticipate price pressure, time entries and exits, and identify periods of relative supply stability.

For investors, the calendar reveals the commitment structure of insiders. A team with a 6-month cliff and fast vesting is positioned to exit quickly. A team with a 12-month cliff and 36-month vesting has signaled a multi-year commitment. The shape of the unlock calendar tells the story of who can sell what, and when.

For project founders, the calendar is a design tool. Distributing unlock events evenly across the timeline prevents any single month from creating overwhelming sell pressure. Stacking multiple large unlocks in the same month is a common design mistake that a calendar view immediately reveals.

Reading an Unlock Calendar

A well-constructed unlock calendar includes several pieces of information for each event:

• Month: When the unlock occurs (relative to TGE)
• Category: Which allocation group is unlocking (team, advisors, community, etc.)
• Tokens unlocked: Absolute number of tokens released
• Percentage of supply: Tokens released as a percentage of total supply
• Cliff drop flag: Whether this event exceeds the 5% threshold for large unlocks

The most dangerous periods on an unlock calendar are months where multiple categories experience cliff-end events simultaneously. If the team cliff ends at month 12 and the advisor cliff ends at month 12, the combined unlock could be substantially larger than either alone.

The 5% Warning Threshold

Not all unlock events are equally impactful. Small vesting releases of 0.1-0.5% of total supply are easily absorbed by normal trading activity. But when a single event releases more than 5% of total supply, the market dynamics shift. The liquidity available on exchanges may not be sufficient to absorb that much new supply without a price impact.

The 5% threshold is a commonly used warning line. Above this level, an unlock event is flagged as a cliff drop — a supply shock that warrants attention from anyone holding or trading the token. Some aggressive tokenomics designs produce cliff drops of 10-15% of total supply, which can create severe short-term price dislocations.

Quarterly vs Monthly vs Linear: Calendar Impact

The choice of vesting curve dramatically affects the shape of the unlock calendar:

Linear vesting produces no discrete events after the cliff ends. Tokens flow continuously into circulation. The calendar for a linearly vesting category shows a smooth ramp with no spikes.

Monthly step vesting produces small, predictable events every month. A 15% allocation vesting over 24 months releases approximately 0.625% of total supply each month. These events are small enough to be absorbed by normal trading.

Quarterly step vesting concentrates three months of vesting into a single event every quarter. That same 15% allocation on quarterly steps releases approximately 1.875% of total supply every three months. These events are large enough to appear as visible bars on an unlock calendar chart.

Building an Effective Calendar

When designing a tokenomics calendar, follow these principles:

1. Stagger cliff-end dates across categories. Do not set all insider cliffs to the same month.
2. Avoid stacking multiple large unlocks in the same month. If team cliff ends at month 12, set advisor cliff at month 6 or 9.
3. Use linear or monthly vesting for large categories. Reserve quarterly vesting for smaller allocations where the lumpy releases are proportionally small.
4. Keep TGE unlocks modest. Under 10% total circulating supply at TGE is considered healthy. Under 5% for insiders specifically.
5. Publish the calendar publicly and keep it updated. Transparency builds trust and allows the market to price in unlocks efficiently.

Try It Yourself

Build My Tokenomics generates a complete unlock calendar through the findUnlockEvents() function. It identifies every TGE unlock, cliff-end release, and quarterly step event across all your allocation categories. The bar chart visualization displays events chronologically with a 5% cliff-drop warning line, and events are color-coded by allocation category so you can see which groups drive the largest supply increases. Try configuring two categories with the same cliff month, then stagger them — the visual difference in the chart immediately shows why avoiding overlap matters.

Related Concepts

• Cliff Period defines the lock-up duration before any vesting tokens become available, creating the cliff-end unlock events that dominate most calendars.
• Cliff Drop is the specific term for unlock events exceeding 5% of total supply, flagged as high-impact supply shocks.
• Vesting Schedule controls the release pattern (linear, monthly, quarterly) that determines how tokens flow after a cliff ends.
• Circulating Supply increases with every unlock event, and the calendar is the roadmap for predicting its growth over time.

Frequently Asked Questions

What is considered a large token unlock event?

Any single unlock event that releases more than 5% of total supply is generally considered large and potentially market-moving. Build My Tokenomics flags these as cliff drops with a warning indicator. Events releasing 2-5% are moderate and worth monitoring. Events under 2% are typically absorbed by normal market activity without significant price impact.

How do unlock calendars affect token price?

Large unlock events tend to create downward price pressure in two phases. First, anticipatory selling occurs in the days or weeks before a known unlock as traders front-run expected supply increases. Second, actual selling occurs as unlock recipients (particularly insiders) liquidate portions of their newly accessible tokens. The magnitude of the price impact depends on the unlock size relative to daily trading volume and overall market conditions.

What is the difference between a cliff unlock and a vesting release?

A cliff unlock happens on a specific date when the cliff period ends, releasing a batch of tokens all at once. A vesting release is an ongoing process where tokens are distributed continuously (linear vesting) or at regular intervals (monthly or quarterly steps). Cliff unlocks create sharp, one-time supply increases, while vesting releases create gradual, predictable supply growth. The most impactful events combine both: a cliff end that also begins a vesting stream.

Should I avoid buying tokens before a large unlock event?

Large unlock events do not always cause price drops, but they introduce additional risk. The market often prices in known unlocks ahead of time, so the actual event may have less impact than expected. However, if the unlocking entity is likely to sell (such as early investors realizing profits), buying before the unlock means you are accepting supply dilution risk. Checking the unlock calendar and assessing the motivations of the unlocking party is standard due diligence.

How far in advance should I plan for unlock events?

Most tokenomics analysts track unlock events at least 30-90 days in advance. Major cliff drops for large categories (team, private sale) should be on your radar from the moment vesting terms are published. The most sophisticated market participants build 12-month forward calendars and adjust their positions as unlock dates approach. For project founders, designing the calendar to avoid multiple large unlocks in the same month is a best practice.

← Back to Learn

For educational purposes only. Not financial, investment, or legal advice. See Terms of Service.