Vesting & Token Unlocks

Vesting Schedule Chart

Description

Per-round (allocation) token release schedule over time: cliff/linear/batch phases with dates, share, and token amounts. Data for the vesting schedule chart.

Note: Allocations without a tracked schedule are summarized in the untracked block, not listed as rounds. Amounts are in the project's native token.

Access

Available from: Pro
Cost: 1 credit per request

get/v3/currencies/{id}/vesting/schedule

Request

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

Path parameters

idinteger required

Example:1

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

Query parameters

sortBy'percentOfTotal' | 'name'

Sort field: round share of total supply or round name.

sortOrder'asc' | 'desc'

Sort direction.

Response

Example response

{
  "data": {
    "rounds": [
      {
        "allocationId": 17132,
        "allocationName": "Private Sale Investors",
        "lockedPercent": 66.67,
        "lockedTokens": "10000000",
        "name": "Private Sale Investors",
        "percentOfTotal": 34.9,
        "phases": [
          {
            "endTime": 1746000000000,
            "frequency": "monthly",
            "percentPerPeriod": 6.05,
            "periods": 12,
            "startTime": 1715000000000,
            "type": "linear",
            "unlockPercent": 72.6,
            "unlockTokens": "12500000"
          }
        ],
        "tgeUnlockPercent": 10,
        "totalTokens": "15000000",
        "type": "linear",
        "unlockedPercent": 33.33
      }
    ],
    "untracked": {
      "allocationIds": [
        24842,
        17133
      ],
      "allocationNames": [
        "Arbitrum Foundation",
        "DAO Treasury"
      ],
      "percentOfTotal": 42.78,
      "totalTokens": "4278000000"
    }
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

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