# Crypto Token Unlocks & Vesting Schedule Scraper (`scrapers_lat/crypto-token-unlocks-scraper`) Actor
Scrape upcoming crypto token unlocks and vesting schedules: next unlock date, token amount, USD value, percent of circulating and max supply, locked supply and the team, investor and community allocation split. Track supply inflation events across hundreds of tokens. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/crypto-token-unlocks-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $10.20 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Crypto Token Unlocks & Vesting Schedule Scraper
> Track upcoming crypto token unlocks across hundreds of tokens. Get the next unlock date, token amount, USD value, percent of circulating and max supply, locked supply and the full team, investor and community allocation split. Upcoming unlocks are supply inflation events and one of the clearest trading signals in crypto.
Next unlock date, amount, USD value
Supply impact % of circulating & max
JSON / CSV / Excel output formats
### Who is it for
| Use case | Who benefits |
|---|---|
| Trading and risk | Traders sizing positions around supply inflation events |
| Research | Analysts studying tokenomics, vesting and dilution |
| Portfolio monitoring | Funds tracking unlock calendars across their holdings |
| Dashboards | Builders feeding an unlock calendar into their own apps |
### How to use it
1. Pick a **mode**: *upcoming unlocks* scans every tracked token and returns those with a coming unlock, or *by token* returns detail only for the tokens you name.
2. Optionally add **tokens** to look up, a **search** filter, or a **days ahead window** (for example the next 30 or 90 days).
3. Choose a **sort** (soonest date or largest USD value), set **Max Items** and run. Export as JSON, CSV or Excel, or pull it through the Apify API.
### Frequently Asked Questions
**What does percent of circulating mean?**
It is the size of the next unlock divided by the tokens already in circulation. A large percent means the unlock adds a lot of new supply relative to what is already trading, which is often a bearish pressure signal.
**How is the USD value calculated?**
The next unlock token amount is valued at the token's current price at run time, so each record reflects the value at the moment of the run (see observedAt).
**Can I track just a few specific tokens?**
Yes. Use the by-token mode and list the token or protocol slugs you care about (for example `ondo-finance`, `pyth`, `aethir`).
**How fresh is the data?**
Schedules, supply metrics and prices are read live at run time, so each record reflects the token at the moment of the run.
### Related scrapers
- [Polymarket Prediction Markets & Odds Scraper](https://apify.com/scrapers_lat/polymarket-markets-scraper)
- [Yahoo Finance Scraper](https://apify.com/scrapers_lat/yahoo-finance-scraper)
- [Google News Scraper](https://apify.com/scrapers_lat/google-news-scraper)
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms: finance, news, real estate, jobs, e-commerce and government data. Browse the full catalog or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with any token issuer or data provider. It only accesses publicly available token unlock data. Use the results in accordance with the source's terms.
# Actor input Schema
## `maxTokens` (type: `integer`):
Maximum number of token unlock records to return.
## `mode` (type: `string`):
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 tokens you name below.
## `tokens` (type: `array`):
Optional. Token or protocol slugs to look up (for example 'ondo-finance', 'pyth', 'aethir', 'arbitrum'). Used mainly with the by-token mode.
## `token` (type: `string`):
Optional. Keep only tokens whose slug contains this text (for example 'arb', 'sui', 'jup').
## `daysAhead` (type: `integer`):
Optional. In upcoming-events mode, keep only unlocks happening within this many days from now (for example 30 or 90). Leave empty for no time limit.
## `sort` (type: `string`):
Order upcoming unlocks by the soonest date, or by the largest USD value of the unlock.
## Actor input object example
```json
{
"maxTokens": 30,
"mode": "upcoming-events",
"tokens": [
"ondo-finance",
"pyth",
"aethir"
],
"sort": "date"
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxTokens": 30,
"mode": "upcoming-events",
"tokens": [
"ondo-finance",
"pyth",
"aethir"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/crypto-token-unlocks-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxTokens": 30,
"mode": "upcoming-events",
"tokens": [
"ondo-finance",
"pyth",
"aethir",
],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/crypto-token-unlocks-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxTokens": 30,
"mode": "upcoming-events",
"tokens": [
"ondo-finance",
"pyth",
"aethir"
]
}' |
apify call scrapers_lat/crypto-token-unlocks-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/crypto-token-unlocks-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Crypto Token Unlocks & Vesting Schedule Scraper",
"description": "Scrape upcoming crypto token unlocks and vesting schedules: next unlock date, token amount, USD value, percent of circulating and max supply, locked supply and the team, investor and community allocation split. Track supply inflation events across hundreds of tokens. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "96zTbAQhSG8fzlUL2"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~crypto-token-unlocks-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-crypto-token-unlocks-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~crypto-token-unlocks-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-crypto-token-unlocks-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~crypto-token-unlocks-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-crypto-token-unlocks-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxTokens": {
"title": "Max token unlock records",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of token unlock records to return."
},
"mode": {
"title": "Mode",
"enum": [
"upcoming-events",
"by-token"
],
"type": "string",
"description": "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 tokens you name below.",
"default": "upcoming-events"
},
"tokens": {
"title": "Tokens",
"type": "array",
"description": "Optional. Token or protocol slugs to look up (for example 'ondo-finance', 'pyth', 'aethir', 'arbitrum'). Used mainly with the by-token mode.",
"items": {
"type": "string"
}
},
"token": {
"title": "Search",
"type": "string",
"description": "Optional. Keep only tokens whose slug contains this text (for example 'arb', 'sui', 'jup')."
},
"daysAhead": {
"title": "Days ahead window",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "Optional. In upcoming-events mode, keep only unlocks happening within this many days from now (for example 30 or 90). Leave empty for no time limit."
},
"sort": {
"title": "Sort by",
"enum": [
"date",
"value"
],
"type": "string",
"description": "Order upcoming unlocks by the soonest date, or by the largest USD value of the unlock.",
"default": "date"
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```