Token Unlock Dynamics by Category
Description
Returns market-wide token unlock dynamics as a time series (history and forecast), split by coin primary category.
Note: Untracked allocations are excluded. Unlock value is computed from each token's current price, for both past and upcoming unlocks. Tokens whose price has stopped updating are left out.
Note: Coins without a category are grouped into a single Uncategorized entry, always placed last, so the breakdown always adds up to totalUnlockValue.
Tip: Without from/to the window is skewed towards upcoming unlocks, sized to the selected interval. Both bounds snap to interval bucket starts. One response carries at most 366 daily, 520 weekly or 1000 monthly points — wider ranges have to be requested in slices.
Access
- Available from: Advanced
- Cost: 1 credit per request
Request
- Base URL: https://api.cryptorank.io
- URL: https://api.cryptorank.io/v3/token-unlocks/dynamics/by-category
- Auth: API key in header X-Api-Key
Query parameters
Bucket size for aggregation: 1d — daily, 1w — weekly (ISO week, starts Monday), 1m — monthly.
Lower bound on the unlock date, snapped down to the start of its interval bucket. Accepts ISO 8601 string or Unix timestamp (sec/ms). Defaults to the history side of the window for the selected interval.
Upper bound on the unlock date, snapped down to the start of its interval bucket, which is then included in full. May be in the future — upcoming unlocks are part of the series. Accepts ISO 8601 string or Unix timestamp (sec/ms). Defaults to the forecast side of the window for the selected interval.
Fiat ISO code for monetary fields (e.g. USD, EUR, RUB, AED). See: GET /v3/fiat/list.
Response
Example response
{
"data": [
{
"breakdown": [
{
"id": 54,
"key": "gamefi",
"name": "GameFi",
"unlockValue": "48200000"
}
],
"date": "2026-08-01T00:00:00.000Z",
"totalUnlockValue": "1250000000"
}
],
"status": {
"timestamp": 1780000000000,
"usedCredits": 1
}
}Changes
No recorded changes to this operation across all 1 revision of this API.