token-unlock-treasury

Token Unlock & Treasury Analysis

Overview

Track token vesting schedules, upcoming unlock events, and project treasury holdings to forecast sell pressure and assess project sustainability. Token unlocks are one of the most predictable and high-impact supply-side events in crypto — large unlocks consistently create short-term selling pressure.

Core Concepts

1. Token Distribution Taxonomy

Standard allocation categories:

Category	Typical %	Lock Period	Vesting	Sell Pressure Risk
Team / Founders	15-25%	12-24 months cliff	2-4 year linear	High (sell to fund lifestyle / diversify)
Investors (Seed)	5-15%	6-12 months cliff	1-2 year linear	Very high (VC fund lifecycle: must return capital)
Investors (Series A+)	10-20%	6-12 months cliff	1-2 year linear	Very high
Ecosystem / Community	20-40%	Variable	Ongoing emissions	Medium (depends on incentive design)
Treasury / Foundation	10-20%	None (discretionary)	DAO-governed	Low-medium (depends on governance)
Public Sale / Airdrop	5-15%	None	Immediately liquid	Initial dump, then stabilizes
Advisors	2-5%	6-12 months cliff	1-2 year linear	Medium

2. Unlock Event Types

Cliff unlock:

• Large one-time release after lock period expires
• Most impactful: 5-30% of supply unlocking in a single event
• Typical impact: -5% to -20% price decline in the 7 days around a cliff unlock

Linear / continuous unlock:

• Steady stream of tokens released over time (daily/weekly/monthly)
• Creates persistent but predictable sell pressure
• Impact depends on rate relative to trading volume

Milestone-based unlock:

• Triggered by protocol metrics (TVL target, user count, etc.)
• Less predictable but usually positive signal (means protocol is growing)

3. Unlock Impact Assessment

def assess_unlock_impact(unlock_amount, circulating_supply, daily_volume, recipient_type):
    """
    Assess the market impact of an upcoming token unlock.
    """
    # Unlock as % of circulating supply
    supply_pct = unlock_amount / circulating_supply * 100

    # Unlock as multiple of daily volume
    volume_multiple = unlock_amount / daily_volume

    # Base impact score
    if supply_pct > 10:
        base_impact = "critical"      # >10% of supply = very high impact
    elif supply_pct > 5:
        base_impact = "high"
    elif supply_pct > 2:
        base_impact = "medium"
    elif supply_pct > 0.5:
        base_impact = "low"
    else:
        base_impact = "negligible"

    # Adjust for recipient type (who receives the tokens)
    recipient_multiplier = {
        "team": 0.7,         # Team sells ~70% within 6 months historically
        "investor_seed": 0.8, # VCs must return capital, sell aggressively
        "investor_later": 0.6,
        "ecosystem": 0.3,    # Ecosystem tokens often re-staked or used
        "treasury": 0.2,     # Treasury rarely dumps (governance constraints)
        "community": 0.5,    # Mixed behavior
    }

    effective_sell_pressure = supply_pct * recipient_multiplier.get(recipient_type, 0.5)

    # Volume absorption capacity
    if volume_multiple > 5:
        absorption = "illiquid"       # Market cannot absorb easily
    elif volume_multiple > 2:
        absorption = "difficult"
    elif volume_multiple > 0.5:
        absorption = "manageable"
    else:
        absorption = "easily_absorbed"

    return {
        "supply_impact_pct": supply_pct,
        "base_impact": base_impact,
        "effective_sell_pct": effective_sell_pressure,
        "volume_absorption": absorption,
    }