Unlock Events v5
Cliff unlocks per token. v5 moves tokenId to a path param, adds pagination, adds optional standardAllocation filter, and adds committedClaim data per allocation.
Path parameters
Token identifier (slug). Get from Token List API.
Query parameters
Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.
Comma-separated list of standard allocations to filter by. Allowed values: community, founderTeam, privateInvestors, publicInvestors, others, reserve. Aggregates (cliffAmount, cliffValue) are recalculated from the filtered allocations; events with no matching allocations are excluded.
Page number (1-indexed).
Number of rows per page.
Response
Successful response
Example response
{
"metadata": {
"queryDate": "2026-01-08T10:13:58Z",
"credit": {
"used": 213,
"limit": 300,
"resetAt": "2026-08-01T00:00:00Z"
},
"page": 1,
"pageSize": 50,
"totalPages": 10,
"total": 487
},
"data": [
{
"unlockDate": "2024-09-16T13:00:00Z",
"tokenName": "Arbitrum",
"tokenSymbol": "ARB",
"listedMethod": "INTERNAL",
"dataSource": "Whitepaper",
"cliffUnlocks": {
"cliffAmount": 92645833.29999995,
"cliffValue": 49929711.58620228,
"valueToMarketCap": 2.7744266354166256,
"allocationBreakdown": [
{
"unlockDate": "2024-09-16T13:00:00Z",
"allocationName": "Investors",
"standardAllocationName": "Private Investors",
"cliffAmount": 36520833.29999995,
"cliffValue": 19682209.211202275,
"referencePrice": 0.538931,
"referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
"unlockPrecision": "month",
"committedClaim": {
"amount": 1234567.89,
"value": 987654.32,
"timestamp": 1735689600
}
}
]
},
"latestUpdateDate": "2024-06-11T08:49:27Z"
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.