Token Unlock Calendar

Track upcoming token unlocks across hundreds of crypto projects. Filter by USD value, % of circulating supply, time window, or symbol. Spot supply-overhang risks before VCs dump.

---

What It Does

Pulls the upcoming token unlock schedule from CryptoRank's public data and returns it as a clean dataset. Use it to:

• See when major VC/team/treasury allocations unlock in the next N days
• Filter to only "large" unlocks (e.g., >$10M or >1% of circulating supply)
• Time entries around post-unlock dips (or short rallies into unlocks)
• Build automated supply-overhang alerts before the market notices

---

Why Unlocks Matter

When locked tokens (allocated to early investors, team, or treasury) hit the open market, they often trigger sell pressure. Large unlocks — especially those that meaningfully inflate circulating supply — have historically caused 10–30% drawdowns in the days surrounding the event.

This actor gives you the calendar + sizing data to know what's coming before retail does.

---

Input

Field	Type	Default	Description
daysAhead	integer	30	Only return unlocks within this many days
minUnlockValueUsd	integer	1000000	Min USD value of the unlock
minPercentOfCircSupply	number	0.5	Min % of current circulating supply being unlocked
symbols	string[]	[]	If non-empty, only return these symbols (e.g. APT, ARB)
sortBy	string	date_asc	date_asc, value_desc, percent_desc
limit	integer	100	Max results (1–500)
alertValueUsd	integer	0	Send Telegram alert when any unlock exceeds this USD. 0 = disabled
telegramBotToken	string (secret)	—	Telegram bot token for alerts
telegramChatId	string	—	Chat ID to receive alerts

Example: Major unlocks in the next 14 days

{
  "daysAhead": 14,
  "minUnlockValueUsd": 5000000,
  "minPercentOfCircSupply": 1.0,
  "sortBy": "value_desc"
}

Example: Daily Telegram alert on any $10M+ unlock

{
  "daysAhead": 7,
  "alertValueUsd": 10000000,
  "telegramBotToken": "<token>",
  "telegramChatId": "<chat_id>"
}

---

Output

Each record represents one upcoming unlock event:

{
  "symbol": "APT",
  "name": "Aptos",
  "slug": "aptos",
  "unlock_date": "2026-06-12T00:00:00+00:00",
  "days_until_unlock": 10.0,
  "price_usd": 8.42,
  "market_cap_usd": 5800000000,
  "price_change_24h_pct": -2.10,
  "circulating_supply": 819910797,
  "tokens_unlocking": 11304870,
  "unlock_value_usd": 95187006,
  "unlock_percent_of_circ_supply": 1.38,
  "locked_tokens": 383679399,
  "locked_tokens_percent": 31.88,
  "primary_allocation": "Community",
  "allocations": [
    {"name": "Community", "tokens": 7570860, "value_usd": 63746640},
    {"name": "Core Contributors", "tokens": 1867020, "value_usd": 15720508},
    {"name": "Foundation", "tokens": 1866990, "value_usd": 15720256}
  ],
  "top_investors": ["Andreessen Horowitz", "Multicoin Capital", "Jump Crypto"],
  "cryptorank_url": "https://cryptorank.io/price/aptos/vesting",
  "fetched_at": "2026-06-02T12:15:00+00:00"
}

Field	Description
unlock_value_usd	Tokens unlocked × current spot price
unlock_percent_of_circ_supply	How much current circulating supply increases on this date
primary_allocation	Largest single allocation type unlocking (Team / Investors / Treasury / Community / etc)
locked_tokens_percent	% of max supply still locked after this unlock

---

Pricing

Pay-Per-Event (PPE):

• $0.005 per unlock event returned

Examples:

• Top 50 unlocks next 30 days: $0.25
• Full 300-unlock sweep: $1.50

---

Use Cases

Pre-unlock short scout — Find tokens with major dilution in the next 7 days:

curl -X POST "https://api.apify.com/v2/acts/gochujang~token-unlock-calendar/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"daysAhead": 7, "minPercentOfCircSupply": 2, "sortBy": "percent_desc"}'

Auto-alert on whale unlocks — Get pinged when any unlock exceeds $20M:

{
  "daysAhead": 30,
  "alertValueUsd": 20000000,
  "telegramBotToken": "<token>",
  "telegramChatId": "<chat>"
}

---

Data Source

All unlock data comes from CryptoRank — the most comprehensive vesting-schedule source for crypto. Each scrape returns ~400 upcoming unlock events across the broader market.

---

Related Actors

Build a complete crypto edge with these actors from the same author:

• Smart Money Wallet Tracker — Track 238 smart wallets to see early VC moves before unlocks.
• CEX Funding Rate Aggregator — Detect over-leveraged positioning across Binance/Bybit/OKX.
• DeFi Yield Scanner — Best APY across 17,000+ DeFi pools.

---

Feedback

If this Actor saves you time, a quick review helps others find it: Leave a review on Apify Store