v1
latestOpenAPI 3.0.32026-07-26282561.6 KBUnlock Events
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.
get/v5/unlock/events/{tokenId}
Path parameters
tokenIdstring required
Token identifier (slug). Get from Token List API.
Query parameters
startstring date
Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
endstring date
End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.
standardAllocationstring
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.
pageinteger
Page number (1-indexed).
pageSizeinteger
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"
}
]
}