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:

• Airdrop & Quest Tracker (Galxe) — Spot the next farming campaigns; those tokens later show up here.
• Smart Money Wallet Tracker — Track 238 smart wallets to see early VC moves before unlocks.
• Hyperliquid Whale Tracker — Whale perp positions around unlock events.
• CEX Funding Rate Aggregator — Over-leveraged positioning context before unlock dumps.

---

---

🎬 Live Sample Run

A real run of this actor with default-ish inputs, executed on 2026-06-10:

Field	Value
Items in dataset	30
Dataset (JSON)	https://api.apify.com/v2/datasets/xm926RWjt9PVfn7gF/items?clean=1&format=json
Dataset (CSV)	https://api.apify.com/v2/datasets/xm926RWjt9PVfn7gF/items?clean=1&format=csv
Run summary (KVS)	https://api.apify.com/v2/key-value-stores/IY7FmBL36MNW57aGj/records/SUMMARY
Run details	https://api.apify.com/v2/actor-runs/Jse2STAVBA7l8gYcg

Try it now: pop any of the dataset URLs in your browser to see live output, or hit the API endpoints from your code.

Want to reproduce? Click Try Actor on the Apify Store page and use the input defaults shown above.

Feedback

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