Token Unlock Calendar

Track upcoming cliff token unlocks for selected crypto projects using public DeFiLlama emission schedules and keyless market snapshots.

Quick start

The Console prefill uses daysAhead: 30, minUnlockValueUsd: 1000000, and minPercentOfCircSupply: 0.5. It returned one Aptos event on 2026-10-11; counts change as schedules and prices change.

{}

Each dataset item retains the actor's existing output fields. For example, a real 2026-10-11 Aptos item included symbol: "APT", tokens_unlocking: 11309783, unlock_value_usd: 9539982.92, unlock_percent_of_circ_supply: 1.2978, and four allocations (Community, Core Contributors, Foundation, Investors). The event date was 2026-10-11T23:14:24+00:00.

Source and limits

• The free DeFiLlama all-emissions endpoint returns HTTP 402. This actor instead reads public per-protocol emission datasets for four projects with upcoming cliff allocations as checked on 2026-10-11: Aptos, Arbitrum, Celestia and Avalanche. This is not a market-wide unlock index. Other public datasets (Hyperliquid, Worldcoin, Filecoin, Chainlink and Uniswap) had no upcoming cliff allocations at that check, so are not fetched.
• Only explicit cliffAllocations become events. Ongoing linear emissions and events without a positive token amount are excluded. A symbol filter outside the listed projects returns no items.
• CoinGecko's public market endpoint supplies current price, market cap, circulating supply, and 24-hour change. On throttling or server errors the actor retries, then uses the keyless CoinPaprika ticker where available. CoinPaprika omits circulating supply in this response; the fallback derives it as market_cap / price, so the percentage is an approximation from that snapshot. If both sources lack price/supply, price_usd, unlock_value_usd, unlock_percent_of_circ_supply, and/or allocation value_usd are null; the default USD and percent filters then exclude that event. No zero-value result is presented as a measured value.
• DeFiLlama's public schedule does not provide the CryptoRank investor list, remaining locked balance, or historical price response. top_investors, investor_profile, locked_tokens, locked_tokens_percent, historical_unlock_pattern, unlock_vs_daily_volume_ratio, market_timing_risk, counter_strategy, and cryptorank_url are null. cumulative_unlocked_pct is also null without a reliable locked balance. Remaining pressure/impact scores are heuristics based on unlock size and allocation, not predictions or observed price impact.
• chains remains an accepted input but is not applied: the public schedule does not consistently identify an event's chain. An unavailable upstream source may produce zero results. No API key is required.

Input

Field	Default	Meaning
daysAhead	30	Future UTC window, including today's scheduled events
minUnlockValueUsd	1000000	Minimum current-price USD value; 0 disables the filter
minPercentOfCircSupply	0.5	Minimum percentage of current circulating supply; 0 disables the filter
symbols	[]	Optional ticker-symbol filter
sortBy	date_asc	date_asc, value_desc, percent_desc, or pressure_desc
limit	100	Maximum dataset items, up to 500
alertValueUsd, alertMinUnlockPct, alertDaysAhead	0, 1, 7	Optional Telegram alert thresholds
telegramBotToken, telegramChatId	unset	Credentials for optional alerts

The existing minUnlockUsd alias remains in the input schema but is not applied by the actor. chains is also currently not applied. Set the supported filters above for predictable results.

Output

unlock_date is the source's UTC cliff timestamp; tokens_unlocking sums its allocation amounts. allocations retains each named tranche and its value at the current market price. unlock_value_usd is token count multiplied by that price, and unlock_percent_of_circ_supply divides the token count by the current or fallback-implied circulating supply. These USD values are snapshots, not guaranteed future proceeds. The SUMMARY key-value-store record includes counts, applied filters, total returned USD value, and a calendar summary.

Pricing

The first 10 unlock results are free per account under the actor's shared billing helper. Later unlock-tracked results are $0.005 each; the apify-actor-start event is $0.001. Confirm the active contract on the Store Pricing tab before running at scale. No unlock-tracked event is charged when no item is returned.

Use from AI agents (MCP)

Connect to Apify's official MCP server and select gochujang/token-unlock-calendar. No separate gateway is needed.

Related actors

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

• Airdrop & Quest Tracker (Galxe) — Spot farming campaigns early; those tokens often appear here later
• Smart Money Wallet Tracker — Track 238 smart wallets to see early VC moves before unlock dumps
• Hyperliquid Whale Tracker — Whale perp positioning around unlock events
• CEX Funding Rate Aggregator — Identify over-leveraged crowding before major unlock supply hits

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

Keywords: token unlock, vesting schedule, supply shock, cliff unlock, TGE, token release, crypto calendar, dilution risk, circulating supply, token lockup, investor unlock, project vesting