Skip to main content
GET
/
v3
/
currencies
/
{id}
/
vesting
/
chart
Token Emission Chart
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/{id}/vesting/chart \
  --header 'X-Api-Key: <api-key>'
{
  "series": [
    {
      "time": 1715000000000,
      "unlockedTokens": "125000",
      "unlockedPercent": 0.08,
      "cumulativeUnlockedTokens": "527400000",
      "cumulativeUnlockedPercent": 84
    }
  ],
  "untracked": {
    "totalTokens": "50000000",
    "shareOfTotal": 5,
    "allocationNames": [
      "Ecosystem",
      "Treasury"
    ]
  }
}
Untracked allocations are excluded — cumulative values may stay below total supply.
There is no interval parameter — granularity is selected automatically from the range: daily for ranges up to 3 years, weekly beyond.
Per-round release rules behind this chart: /currencies/:id/vesting/schedule. Discrete unlock events: /currencies/:id/vesting/events.

Authorizations

X-Api-Key
string
header
required

Path Parameters

id
integer
required

Numeric coin id.

Example:

1

Query Parameters

from
string

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

to
string

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

series
object[]
required

Token emission time series. Interval granularity is selected automatically: daily for ranges up to 3 years, weekly beyond.

untracked
object
required

Allocations excluded from the series because they have no known unlock schedule. Their tokens are not counted in the cumulative totals, so cumulative values may stay below total supply.