Token Unlock Tracker — Vesting Schedules & Cliff Alerts

Track upcoming token unlocks and vesting schedules with the numbers that actually move price. This token unlock calendar returns, for every upcoming cliff or linear unlock: the date, the amount released, the % of circulating supply unlocked (dilution / sell pressure), the USD value, a big-unlock flag, and the per-beneficiary breakdown (team / investors / ecosystem). Built for trading bots, AI agents and analysts who need a clean token vesting API instead of a screenshot of a website.

Most unlock tools give you a calendar. This one gives you actionable supply-unlock data: the headline figure is % of circulating supply, because a 5% unlock going to early investors is a very different trade than a 0.1% ecosystem drip.

What it does

• Upcoming unlocks per token — date, type (cliff / linear / mixed), tokens released.
• % of circulating supply unlocked — the dilution number that matters, using real circulating supply.
• Big-unlock flag — flags any unlock above your threshold (default ≥ 1% of circulating supply).
• USD value — tokens unlocked × live price.
• Beneficiaries — who receives the unlock (investors, insiders, ecosystem, public sale, farming…) — they don't all sell the same way.
• Lookahead window — only unlocks in the next N days.
• Watchlist or all — track specific tokens, or auto-scan every protocol with the biggest upcoming unlocks.
• New-only alert mode — return only unlocks not seen in previous runs (dedup), ideal for scheduled alerts.

What you get per unlock event

Field	Meaning
unlock_date, days_until, unlock_timestamp	When the unlock happens
unlock_type	cliff, linear or mixed
tokens_unlocked	Number of tokens released
pct_of_circulating_supply	Dilution — % of circulating supply unlocked
pct_of_max_supply	% of max supply unlocked
usd_value	USD value at current price
is_big_unlock	Above your big-unlock threshold?
beneficiaries[]	Per-recipient amount, category & % of circulating
beneficiary_categories	Distinct recipient classes (insiders, privateSale, ecosystem…)
circulating_supply, max_supply, price_usd	Context for the numbers

Why this one

• % of circulating supply + cliff flags, not just a date. The differentiator: dilution and sell-pressure, computed for you.
• Beneficiary breakdown — distinguishes insider/investor unlocks (high dump risk) from ecosystem/staking emissions.
• Big-unlock alerts + new-only mode — turn the calendar into a high-signal alert stream for scheduled runs.
• Agent- & bot-ready — one clean JSON row per unlock event, ready for an LLM or a trading strategy.
• Free, official-grade source — DefiLlama emissions for the vesting schedules, CoinGecko for real circulating supply and price. No fragile scraping.

Input

Field	Type	Description
tokens	array	Optional watchlist as DefiLlama slugs / names / CoinGecko ids (e.g. aptos, arbitrum, optimism). Empty = auto-scan the biggest upcoming unlocks.
window_days	integer	Only unlocks within the next N days. Default 30.
big_unlock_pct	number	Flag unlocks ≥ this % of circulating supply. Default 1.
only_big_unlocks	boolean	Return only flagged big unlocks. Default false.
alert_new_only	boolean	Only events new since the last run. Default false.
alert_key	string	Namespace for new-only history.
max_items	integer	Max events returned/charged. Default 50.

Example input

{
  "tokens": [],
  "window_days": 30,
  "big_unlock_pct": 1,
  "only_big_unlocks": false,
  "alert_new_only": false,
  "max_items": 50
}

Output

One dataset item per unlock event. Real output for an EIGEN cliff unlock:

{
  "token": "EigenCloud",
  "symbol": "EIGEN",
  "slug": "eigencloud",
  "gecko_id": "eigenlayer",
  "chain": null,
  "unlock_date": "2026-07-01",
  "unlock_timestamp": 1782933573,
  "days_until": 2,
  "unlock_type": "cliff",
  "tokens_unlocked": 36820227,
  "pct_of_circulating_supply": 4.97,
  "pct_of_max_supply": null,
  "usd_value": 8515893,
  "is_big_unlock": true,
  "circulating_supply": 741228567,
  "circulating_supply_source": "coingecko",
  "max_supply": null,
  "price_usd": 0.231283,
  "beneficiaries": [
    { "recipient": "Investors", "category": "privateSale", "unlock_type": "cliff", "amount": 19749031, "pct_of_circulating_supply": 2.66 },
    { "recipient": "Early Contributors", "category": "insiders", "unlock_type": "cliff", "amount": 17071196, "pct_of_circulating_supply": 2.3 }
  ],
  "beneficiary_categories": ["privateSale", "insiders"],
  "source": "DefiLlama Emissions + CoinGecko",
  "source_url": "https://defillama.com/unlocks/eigencloud",
  "timestamp": "2026-06-29T09:59:29.977Z"
}

This single row tells a trader: in 2 days, EIGEN unlocks 4.97% of circulating supply ($8.5M), and it goes to investors and early contributors — a classic sell-pressure event.

Use cases

• Trading bots — avoid or short tokens ahead of large insider unlocks; gate entries on pct_of_circulating_supply.
• AI research agents — a single tool call returns structured, ranked unlock events to reason over.
• Unlock alerts — schedule with alert_new_only: true and only_big_unlocks: true for a clean, high-signal feed.
• Token & fund due diligence — quantify forward dilution and the insider/investor share of upcoming supply.

Pricing

Pay-per-result: charged per unlock event returned (target $0.003 per result, i.e. $3 / 1,000), plus Apify platform usage. max_items caps your spend; only_big_unlocks and alert_new_only keep scheduled runs cheap. (Final price is set on the Store listing.)

Categories

Developer tools, Automation, Agents.

Data source & method

• Vesting schedules: DefiLlama emissions dataset (free, public) — cliffAllocations / linearAllocations per unlock event.
• Circulating supply & price: CoinGecko public API. When a token isn't on CoinGecko, circulating supply is derived from cumulative past unlocks and flagged via circulating_supply_source: "derived".
• % of circulating supply = tokens unlocked ÷ circulating supply. % of max supply = tokens unlocked ÷ max supply (null when the token has no fixed max supply).

Notes & limits

• Coverage follows DefiLlama's tracked protocols (hundreds of major tokens with documented vesting). Tokens without a published schedule won't appear.
• In "all" mode the actor scans the protocols with the largest upcoming emissions; use the tokens watchlist to force specific tokens regardless of size.
• Informational data, not financial advice. Unlock schedules can change if a project amends its tokenomics.

Use as an MCP tool (AI agents)

This Actor is available as an MCP tool for AI agents (Claude, ChatGPT, Cursor, etc.) through Apify’s hosted MCP server. Point your MCP client at:

https://mcp.apify.com/?actors=aspiring_barricade/crypto-token-unlock-tracker

The Actor’s input schema becomes the tool’s parameters automatically. An Apify API token is required.

Use in n8n

Run this Actor inside your n8n workflows using the official Apify node (search “Apify” in the n8n nodes panel) and select the Actor aspiring_barricade/crypto-token-unlock-tracker. A dedicated community node (n8n-nodes-token-unlock-tracker) is also being published to npm for one-click installation via n8n → Settings → Community Nodes.