Crypto Token Unlocks & Vesting Schedule Scraper

Here is one real result, with every field the actor returns (upcomingUnlocks trimmed to the first 2 of 12 scheduled events for length; all other values are exactly as returned):

{
  "tokenName": "SPCX",
  "symbol": "SPCXB",
  "protocolSlug": "spcx",
  "protocolCategory": null,
  "nextUnlockDate": "2026-08-20T00:00:00.000Z",
  "nextUnlockTimestamp": 1787184000,
  "daysUntilNextUnlock": 5.7,
  "nextUnlockAmountTokens": 319000000,
  "nextUnlockValueUsd": 45254008624,
  "nextUnlockType": "cliff",
  "nextUnlockPercentOfCirculating": 16.59,
  "nextUnlockPercentOfMaxSupply": 2.38,
  "nextUnlockCategories": [
    { "category": "insiders", "amountTokens": 319000000 }
  ],
  "upcomingUnlocks": [
    { "date": "2026-08-20T00:00:00.000Z", "timestamp": 1787184000, "daysUntil": 5.7, "amountTokens": 319000000, "valueUsd": 45254008624, "percentOfCirculating": 16.59, "unlockType": "cliff", "categories": [{ "category": "insiders", "amountTokens": 319000000 }] },
    { "date": "2026-09-09T00:00:00.000Z", "timestamp": 1788912000, "daysUntil": 25.7, "amountTokens": 319000000, "valueUsd": 45254008624, "percentOfCirculating": 16.59, "unlockType": "cliff", "categories": [{ "category": "insiders", "amountTokens": 319000000 }] }
  ],
  "circulatingSupply": 1922855555,
  "maxSupply": 13425865175,
  "totalLocked": 11503009620,
  "percentUnlocked": 14.32,
  "allocationCategories": [
    { "category": "insiders", "percentOfSupply": 71.1 },
    { "category": "publicSale", "percentOfSupply": 28.9 }
  ],
  "priceUsd": 141.862096,
  "marketCapUsd": 272780319338,
  "fullyDilutedValuationUsd": 1904621374339,
  "totalLockedValueUsd": 1631841055001,
  "totalUpcomingUnlocks": 15,
  "url": "https://defillama.com/unlocks/spcx",
  "aiSummary": "On August 20, 2026, a significant unlock of 319 million SPCX tokens will occur, representing 16.59% of the circulating supply. This large influx of tokens, primarily allocated to insiders, could create notable sell pressure.",
  "aiRisk": {
    "riskLevel": "high",
    "redFlags": ["large upcoming unlock as % of circulating (16.59%)", "high team/investor/insider allocation (71.1%)", "low % of supply unlocked to date (14.32%)", "concentrated vesting (insiders only)"],
    "rationale": "The upcoming unlock represents a significant percentage of the circulating supply, which could lead to substantial sell pressure. The high allocation to insiders raises concerns about potential profit-taking."
  },
  "aiTags": ["insider", "cliff", "unlock", "tokenomics", "supply", "marketcap", "cryptocurrency", "longterm", "investment"],
  "source": "DefiLlama Emissions",
  "observedAt": "2026-08-14T07:22:43.113Z"
}

The most complete token unlock scraper available. It returns every field the DefiLlama emissions data exposes for each token, plus derived fields (daysUntilNextUnlock, nextUnlockPercentOfCirculating, percentUnlocked, fullyDilutedValuationUsd) and opt-in AI enrichment, and gives you filters for token, time window and unlock value to target exactly the unlocks you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor reads token emission and vesting data, applies the filters you pass as input, and writes one normalized record per token to the run's dataset. In upcoming-events mode it scans all tracked tokens and returns those with a coming unlock, sorted by soonest date or largest USD value. In by-token mode it returns the full next-unlock detail only for the token slugs you name. Each record includes the next unlock, the forward unlock schedule, circulating and max supply, allocation breakdown, price, market cap and fully diluted valuation. Derived fields such as daysUntilNextUnlock, nextUnlockPercentOfCirculating and percentUnlocked are computed so you can sort and filter without extra parsing. Missing source values are returned as null, never invented.

Three opt-in AI add-ons (aiSummary, aiRisk, aiTags) attach a plain-English unlock summary, a tokenomics red-flag assessment, and topic tags to each record. They are off by default and only run for paying Apify users.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the two largest upcoming unlocks by USD value, enriched with all three AI add-ons.

{
  "mode": "upcoming-events",
  "maxTokens": 2,
  "sort": "value",
  "withAiSummary": true,
  "withAiRisk": true,
  "withAiTags": true
}

Every input field is optional. With an empty input the actor returns upcoming unlocks across all tracked tokens sorted by soonest date (default maxTokens is 30) with the AI add-ons off.

Input reference

Field	Type	Required	Default	Description
maxTokens	integer	no	30	Maximum number of token unlock records to return.
mode	enum	no	upcoming-events	upcoming-events scans all tracked tokens and returns those with a coming unlock; by-token returns the next-unlock detail only for the tokens you name.
tokens	string[]	no	["ondo-finance","pyth","aethir"]	Token or protocol slugs to look up, for example ondo-finance, pyth, arbitrum. Used mainly with by-token mode.
token	string	no	(empty)	Keep only tokens whose slug contains this text, for example arb, sui, jup.
daysAhead	integer	no	(none)	In upcoming-events mode, keep only unlocks happening within this many days from now, for example 30 or 90.
sort	enum	no	date	Order upcoming unlocks by soonest date (date) or largest USD value (value).
withAiSummary	boolean	no	false	Paid add-on. Attach a plain-English AI summary of each token's upcoming unlock. Billed per enriched record; requires a paid Apify plan.
withAiRisk	boolean	no	false	Paid add-on. Attach an AI tokenomics red-flag assessment. Billed per enriched record.
withAiTags	boolean	no	false	Paid add-on. Attach AI-generated topic tags. Billed per enriched record.

Output reference

One dataset item per token. Types: string, number, integer, object[], object, or null when the source value is absent.

Field	Type	Description
tokenName	string	Token or protocol name.
symbol	string	Token ticker symbol, else null.
protocolSlug	string	DefiLlama protocol slug.
protocolCategory	string	Protocol category when known, else null.
nextUnlockDate	string	ISO 8601 date of the next upcoming unlock.
nextUnlockTimestamp	integer	Unix timestamp of the next unlock.
daysUntilNextUnlock	number	Days from run time until the next unlock.
nextUnlockAmountTokens	integer	Token amount unlocking at the next event.
nextUnlockValueUsd	number	USD value of the next unlock at current price.
nextUnlockType	string	Unlock mechanism, for example cliff or linear.
nextUnlockPercentOfCirculating	number	Next unlock as a percentage of circulating supply.
nextUnlockPercentOfMaxSupply	number	Next unlock as a percentage of max supply.
nextUnlockCategories	object[]	{category, amountTokens} breakdown of the next unlock.
upcomingUnlocks	object[]	Forward unlock schedule (up to 12 events), each {date, timestamp, daysUntil, amountTokens, valueUsd, percentOfCirculating, unlockType, categories}.
circulatingSupply	integer	Current circulating token supply.
maxSupply	integer	Maximum token supply.
totalLocked	integer	Tokens still locked (max minus circulating).
percentUnlocked	number	Percentage of max supply currently unlocked.
allocationCategories	object[]	{category, percentOfSupply} allocation breakdown.
priceUsd	number	Current token price in USD, else null.
marketCapUsd	number	Current market capitalization in USD.
fullyDilutedValuationUsd	number	Fully diluted valuation in USD.
totalLockedValueUsd	number	USD value of all locked tokens.
totalUpcomingUnlocks	integer	Count of remaining scheduled unlock events.
url	string	DefiLlama unlocks page URL for the token.
aiSummary	string	Plain-English AI summary. null unless withAiSummary is enabled.
aiRisk	object	AI risk object {riskLevel, redFlags[], rationale}. null unless withAiRisk is enabled.
aiTags	string[]	AI topic tags. null unless withAiTags is enabled.
source	string	Data source label (DefiLlama Emissions).
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	Present only on a failed or no-match run, where a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"mode":"upcoming-events","maxTokens":2,"sort":"value","withAiSummary":true,"withAiRisk":true,"withAiTags":true}), with upcomingUnlocks trimmed to the first event for length:

{
  "tokenName": "SPCX",
  "symbol": "SPCXB",
  "protocolSlug": "spcx",
  "protocolCategory": null,
  "nextUnlockDate": "2026-08-20T00:00:00.000Z",
  "nextUnlockTimestamp": 1787184000,
  "daysUntilNextUnlock": 5.7,
  "nextUnlockAmountTokens": 319000000,
  "nextUnlockValueUsd": 45254008624,
  "nextUnlockType": "cliff",
  "nextUnlockPercentOfCirculating": 16.59,
  "nextUnlockPercentOfMaxSupply": 2.38,
  "nextUnlockCategories": [{ "category": "insiders", "amountTokens": 319000000 }],
  "upcomingUnlocks": [
    { "date": "2026-08-20T00:00:00.000Z", "timestamp": 1787184000, "daysUntil": 5.7, "amountTokens": 319000000, "valueUsd": 45254008624, "percentOfCirculating": 16.59, "unlockType": "cliff", "categories": [{ "category": "insiders", "amountTokens": 319000000 }] }
  ],
  "circulatingSupply": 1922855555,
  "maxSupply": 13425865175,
  "totalLocked": 11503009620,
  "percentUnlocked": 14.32,
  "allocationCategories": [
    { "category": "insiders", "percentOfSupply": 71.1 },
    { "category": "publicSale", "percentOfSupply": 28.9 }
  ],
  "priceUsd": 141.862096,
  "marketCapUsd": 272780319338,
  "fullyDilutedValuationUsd": 1904621374339,
  "totalLockedValueUsd": 1631841055001,
  "totalUpcomingUnlocks": 15,
  "url": "https://defillama.com/unlocks/spcx",
  "aiSummary": "On August 20, 2026, a significant unlock of 319 million SPCX tokens will occur, representing 16.59% of the circulating supply.",
  "aiRisk": {
    "riskLevel": "high",
    "redFlags": ["large upcoming unlock as % of circulating (16.59%)", "high insider allocation (71.1%)"],
    "rationale": "The upcoming unlock represents a significant percentage of the circulating supply, which could lead to substantial sell pressure."
  },
  "aiTags": ["insider", "cliff", "unlock", "tokenomics", "supply"],
  "source": "DefiLlama Emissions",
  "observedAt": "2026-08-14T07:22:43.113Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~crypto-token-unlocks-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"upcoming-events","daysAhead":30,"sort":"value","maxTokens":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~crypto-token-unlocks-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"by-token","tokens":["ondo-finance","pyth","aethir"]}'

Apify CLI:

apify call scrapers_lat/crypto-token-unlocks-scraper \
  --input '{"mode":"upcoming-events","token":"arb","maxTokens":10}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per token record returned (result event). See the pricing tab for the current per-result price.
• Opt-in add-ons. The three AI add-ons (aiSummary, aiRisk, aiTags) are billed as separate events only when they run and actually produce data. They are off unless you enable them on a paid plan.
• No charge on failure. If a run errors or matches nothing, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 token records per run. Upgrade for higher maxTokens.

FAQ and troubleshooting

A run returned 0 records. Why? No tracked token matched your filters. In upcoming-events mode try a larger daysAhead or remove the token search; in by-token mode check the slugs. No-match runs are not charged.

What is the difference between the two modes? upcoming-events scans all tracked tokens and returns those with a coming unlock, sorted. by-token returns the full next-unlock detail only for the token slugs you name.

Why are the USD values so large for some tokens? Values reflect the source emission and price data as published. The actor does not adjust or filter for source anomalies; it returns the numbers exactly as provided.

Why are the AI fields null? The AI add-ons are opt-in and only run for paying Apify users. Enable withAiSummary, withAiRisk, or withAiTags on a paid plan.

How do I find the right token slug? Use the slug from the token's DefiLlama unlocks URL (the url field), for example ondo-finance from defillama.com/unlocks/ondo-finance.

Is this an official DefiLlama tool? No. This actor is independent and reads only publicly available emissions data. Always verify tokenomics before trading.

Related scrapers

• Crypto Airdrops Scraper: active, upcoming and claimable crypto airdrops.
• DeFiLlama Protocols Scraper: DeFi protocol TVL, chains and metrics.
• DAO Governance Scraper: DAO proposals and on-chain governance votes.
• DexScreener Pairs Scraper: live DEX trading pairs and prices.
• CoinGecko Crypto Scraper: coin prices, market caps and rankings.
• Polymarket Markets Scraper: prediction market prices and volumes.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with DefiLlama or any token project. Accesses only publicly available emissions data. Always verify tokenomics before trading.