Token Unlock Schedule
Returns token unlock time-series with cumulative amounts, allocation breakdowns, total supply denominator, and unlocked-supply percentage.
Lookup: by project UUID (id) or token symbol. Filter by date range with from/to — defaults to the current calendar month when omitted.
Important: unlock_amount is a legacy alias for cumulative_unlocked_amount; it is already cumulative at each timestamp and must not be summed across rows. Use unlocked_percentage_of_total_supply for the unlock ratio.
Returns 404 if no token found.
Query parameters
Surf project UUID. PREFERRED — always use this when available from a previous response. Takes priority over symbol.
Surf project UUID. PREFERRED — always use this when available from a previous response. Takes priority over symbol.
Token symbol like ARB, OP, or APT
Token symbol like ARB, OP, or APT
Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01)
Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01)
End of time range. Accepts Unix seconds (1735689600) or date string (2025-01-01)
End of time range. Accepts Unix seconds (1735689600) or date string (2025-01-01)
Response
OK
Example response
{
"$schema": "https://example.com/schemas/DataResponseTokenUnlockPoint.json"
}Changes
No recorded changes to this endpoint across all 1 revision of this API.