Token Unlock Calendar — Upcoming Crypto Unlocks

Get upcoming token unlock events — cliff and linear vesting — as clean structured data: token, unlock date, amount, USD value, % of total supply, and the allocation breakdown (team / investors / airdrop / farming…). Pick a window (today / 7 / 30 / 90 days), filter by minimum USD value or specific tokens, and pipe the rows into your bot, dashboard or alert channel.

Token unlocks are scheduled, market-moving supply events: when a large tranche vests, sell pressure often follows — and it is all known in advance. This actor turns that schedule into an API.

Why this actor

• Three independent sources, one schema. Unlock schedules are aggregated from DefiLlama emissions, Dropstab vesting and CoinMarketCap unlocks (~1,500 tokens combined), merged per token per unlock day. Rows confirmed by multiple sources carry the full provenance list in sources — your cross-validation signal for free.
• A calendar, not a data dump. One row per token per unlock day with the total amount, USD value and per-allocation breakdown — including when different sources round the same cliff to different UTC days (deduplicated automatically). Tokens from different projects sharing a ticker are kept apart.
• Market-impact fields built in. Every row carries value_usd and pct_of_total_supply, so filtering for "unlocks that matter" is one input field (minValueUsd).
• Cliff vs linear. Cliff unlocks (the market-moving ones) are labelled and separable from daily linear emissions.
• Pay per row, capped. Pay-per-event pricing with a hard maxItems cap per run. Optional cross-run deduplication: on a daily schedule you are only charged for events you have not seen yet.
• Push, don't poll. Optional webhook URL — every delivered row is POSTed as JSON to your endpoint (n8n, Make, Zapier, Telegram bridge, your own bot).

Output example

{
  "id": "STRK:2026-08-14",
  "token": "Starknet",
  "symbol": "STRK",
  "unlock_date": "2026-08-14",
  "days_until": 25,
  "amount_tokens": 226356430.83,
  "value_usd": 6454211.45,
  "pct_of_total_supply": 2.26,
  "unlock_type": "cliff",
  "allocations": [
    { "name": "insiders",    "amount_tokens": 147214125.83, "value_usd": 4197588.26 },
    { "name": "privateSale", "amount_tokens": 60392305.0,   "value_usd": 1721995.28 },
    { "name": "liquidity",   "amount_tokens": 18750000.0,   "value_usd": 534627.91 }
  ],
  "sources": ["defillama", "dropstab", "cmc"],
  "info_url": "https://defillama.com/unlocks/starknet-bridge"
}

Use cases

• Trading around unlocks: large cliff unlocks are among the best-documented recurring supply shocks; front-run the calendar instead of reading it on Crypto Twitter after the move.
• Risk management: screen your portfolio / market-making inventory for upcoming supply increases.
• Alerting: daily schedule + dedupe + webhook = a free-to-quiet unlock alert bot for Telegram/Discord/Slack.
• Research & dashboards: historical-forward dataset of unlock events with USD sizing and allocation categories.

Input

Field	Type	Default	Description
sources	array	all 3	defillama, dropstab, cmc
window	select	next30	today, next7, next30, next90
minValueUsd	int	0	Skip unlocks below this USD value — recommended 100000+ (without a floor, small daily linear emissions dominate: ~6,000 rows/30 days vs ~900 at $100k)
tokens	array	—	Only these symbols (e.g. ARB, APT)
maxItems	int	1000	Hard cap on rows (soonest first) = spend cap
dedupe	bool	false	Charge only for never-delivered events (for schedules)
notifyWebhookUrl	string	—	POST every delivered row to this URL

Recommended setups

Market-moving calendar (dashboards, research): window: next30, minValueUsd: 100000 — the complete 30-day calendar of unlocks that matter (~700–900 rows).

Unlock alert bot (Telegram/Discord via webhook): daily Apify Schedule, window: next7, minValueUsd: 1000000, dedupe: true — you are only charged when a new market-moving unlock enters the 7-day window.

Everything (quant pipelines): minValueUsd: 0, maxItems: 5000 — every tracked unlock row including small daily linear emissions.

Pricing (pay-per-event)

You are charged per unlock row delivered plus a small actor-start fee. maxItems caps the spend of any single run; with dedupe enabled, quiet scheduled runs cost only the start fee.

Data sources & reliability

Aggregated from three independent public sources: DefiLlama emissions (340+ protocols with documented vesting schedules, embedded prices and supplies), Dropstab vesting (580+ coins with full forward schedules and cliff/linear/nonlinear typing) and CoinMarketCap unlocks (1,200+ tokens). Each source is fetched independently — one source having issues never blocks the others; source errors are reported in the run log. The actor validates dataset shapes on every run and fails loudly (rather than returning silently empty results) if an upstream source changes.

---

From the same author: Listing Radar — CEX New Listing & Delisting Monitor — official Binance/OKX/Bitget/KuCoin/Upbit announcement feeds, normalized, pay-per-event. Unlocks tell you scheduled supply shocks; listings tell you unscheduled demand shocks. Together they cover both calendars that move altcoin prices.

---

Keywords: token unlock calendar api, upcoming token unlocks, vesting schedule api, token unlock data, crypto unlock tracker, cliff unlock alert, tokenomics vesting data, token emission schedule, unlock calendar bot, arbitrum unlock, token unlock webhook