Vesting & Token Unlocks

Vesting Allocations

Description

Returns the unlock breakdown by allocation group (Team, Private Sale, …).

Note: By default only tracked allocations are returned. includeUntracked=true adds allocations without a known unlock schedule, with isTracked: false and null unlock fields. groupDominance = % of total locked across tracked allocations.

Access

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

Request

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

Path parameters

idinteger required
Example:1

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

Query parameters

includeUntrackedboolean

Include allocations without a known unlock schedule. They come with isTracked: false and null unlock/lock fields. Without it, a coin that has only such allocations returns 404.

Response

Example response

{
  "data": [
    {
      "allocationId": 17132,
      "allocationName": "Private Sale Investors",
      "groupDominance": 12.35,
      "isTracked": true,
      "lockedPercent": 66.67,
      "lockedTokens": "10000000",
      "nextUnlockDate": "2026-07-01T00:00:00.000Z",
      "nextUnlockTokenAmount": "125000",
      "nextUnlockValue": "8125000",
      "percentOfSupply": 15,
      "totalTokens": "15000000",
      "unlockedAmount": "5000000",
      "unlockedPercent": 33.33,
      "vestingType": "linear"
    }
  ],
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

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