Vesting & Token Unlocks

Token Emission Chart

Description

Returns a time series of token emission for a currency.

Note: Untracked allocations are excluded — cumulative values may stay below total supply.

Warning: There is no interval parameter — granularity is selected automatically from the range: daily for ranges up to 3 years, weekly beyond.

Tip: Per-round release rules behind this chart: /currencies/:id/vesting/schedule. Discrete unlock events: /currencies/:id/vesting/events.

Access

  • Available from: Pro
  • Cost: 1 credit per request
get/v3/currencies/{id}/vesting/chart

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/currencies/{id}/vesting/chart
  • Auth: API key in header X-Api-Key

Path parameters

idinteger required
Example:1

Coin ID. See: GET /v3/currencies/map.

Query parameters

fromstring

Range start. Defaults to the token generation event (TGE) date. Accepted: ISO 8601, bare date (YYYY-MM-DD), or Unix timestamp in seconds/milliseconds.

tostring

Range end, inclusive. Defaults to now; may be set in the future to include scheduled unlocks. Accepted: ISO 8601, bare date (YYYY-MM-DD), or Unix timestamp in seconds/milliseconds. Bare dates resolve to end-of-day UTC.

Response

Example response

{
  "data": {
    "series": [
      {
        "cumulativeUnlockedPercent": 84,
        "cumulativeUnlockedTokens": "527400000",
        "time": 1715000000000,
        "unlockedPercent": 0.08,
        "unlockedTokens": "125000"
      }
    ],
    "untracked": {
      "allocationNames": [
        "Ecosystem",
        "Treasury"
      ],
      "percentOfTotal": 5,
      "totalTokens": "50000000"
    }
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.