Vesting & Token Unlocks

Token Unlock Dynamics by Token

Description

Returns market-wide token unlock dynamics as a time series (history and forecast), split by individual token.

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: The top topN tokens are ranked by unlock value over the whole window, so one set of tokens carries the whole series — though a token with no unlocks in a given bucket is absent from that point. Everything outside the top-N is summed into a single Others 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: Pro
  • Cost: 1 credit per request
get/v3/token-unlocks/dynamics/by-token

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/token-unlocks/dynamics/by-token
  • Auth: API key in header X-Api-Key

Query parameters

interval'1d' | '1w' | '1m'

Bucket size for aggregation: 1d — daily, 1w — weekly (ISO week, starts Monday), 1m — monthly.

fromstring
Example:2026-01-01T00:00:00.000Z

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.

tostring
Example:2027-01-01T00:00:00.000Z

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.

convertstring

Fiat ISO code for monetary fields (e.g. USD, EUR, RUB, AED). See: GET /v3/fiat/list.

topNnumber

How many tokens to list separately. Ranked by unlock value over the whole window, so one set of tokens carries the whole series; everything outside it is summed into Others. Up to 50.

Response

Example response

{
  "data": [
    {
      "breakdown": [
        {
          "id": 1054,
          "key": "arbitrum",
          "name": "Arbitrum",
          "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.