Get Token Unlock Events
OpenAPI JSON Spec Retrieve token unlock events for a specific token
Feature Overview Get token unlock schedule and events including cliff unlocks and linear unlocks.
Main Use Cases
- Token Analysis: Understand token unlock schedules for investment decisions
- Market Impact: Analyze potential market impact from upcoming unlocks
- Portfolio Management: Track unlock events for tokens in your portfolio
- Research: Research tokenomics and vesting schedules
Response Data Structure
Each unlock event includes:
- unlock_date: ISO 8601 date string of the unlock event
- token_name: Full name of the token (e.g., “Arbitrum”)
- token_symbol: Token symbol (e.g., “ARB”)
- listed_method: Method of listing (e.g., “INTERNAL”)
- data_source: Source of the data (e.g., “Whitepaper”)
- linear_unlocks: Linear unlock data (can be null)
- cliff_unlocks: Cliff unlock data (can be null)
- latest_update_date: When the data was last updated
Unlock Types
- Cliff Unlocks: One-time unlock of tokens at a specific date
- Linear Unlocks: Gradual unlock of tokens over a period
Allocation Breakdown
Each unlock type includes allocation breakdown with:
- allocation_name: Name of the allocation (e.g., “Investors”)
- standard_allocation_name: Standardized name (e.g., “Private Investors”)
- cliff_amount: Amount of tokens
- cliff_value: Value in USD
- reference_price: Reference price used for calculation
- unlock_precision: Precision of unlock (e.g., “month”, “day”)
Usage Examples
-
Get all unlock events for Arbitrum:
?token_id=arbitrum -
Get unlock events for a specific date range:
?token_id=arbitrum&start=2024-01-01&end=2024-12-31 -
Get unlock events for Optimism:
?token_id=optimism
Important Notes
- token_id is required
- start and end dates are optional (format: YYYY-MM-DD)
- linear_unlocks and cliff_unlocks can be null if not applicable
Authorizations
API Key authentication. Example: "your-api-key-here"
Query Parameters
Token identifier (e.g., arbitrum, optimism, sui)
Start date (YYYY-MM-DD format)
End date (YYYY-MM-DD format)

