Skip to main content
GET
/
v3
/
currencies
/
{id}
/
vesting
/
allocations
Vesting Allocations
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/{id}/vesting/allocations \
  --header 'X-Api-Key: <api-key>'
[
  {
    "allocationName": "Private Sale Investors",
    "totalAmount": "15000000",
    "percentOfSupply": 15,
    "unlockedAmount": "5000000",
    "unlockedPercent": 33.33,
    "lockedAmount": "10000000",
    "lockedPercent": 66.67,
    "groupDominance": 12.35,
    "nextUnlockDate": "2026-07-01T00:00:00.000Z",
    "nextUnlockTokenAmount": "125000",
    "nextUnlockUsdAmount": "8125000",
    "vestingType": "linear"
  }
]
Untracked allocations are excluded. groupDominance = % of total locked.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
integer
required

Numeric coin id.

Example:

1

Response

​
allocationName
string
required

Allocation name (e.g. Team, Private Sale).

Example:

"Private Sale Investors"

​
totalAmount
string
required

Allocation size — total tokens in this category.

Example:

"15000000"

​
percentOfSupply
number | null
required

Allocation size relative to total supply, in percent.

Example:

15

​
unlockedAmount
string
required

Tokens already unlocked in this allocation.

Example:

"5000000"

​
unlockedPercent
number
required

Share unlocked within the allocation, % of its totalAmount.

Example:

33.33

​
lockedAmount
string
required

Allocation tokens still locked.

Example:

"10000000"

​
lockedPercent
number
required

Share locked within the allocation, % of its totalAmount.

Example:

66.67

​
groupDominance
number
required

Share of this allocation in the total locked tokens across all allocations, %.

Example:

12.35

​
nextUnlockDate
string | null
required

Closest upcoming unlock date for this allocation (ISO 8601 UTC). Null when no upcoming unlock.

Example:

"2026-07-01T00:00:00.000Z"

​
nextUnlockTokenAmount
string | null
required

Tokens in the closest upcoming unlock for this allocation.

Example:

"125000"

​
nextUnlockUsdAmount
string | null
required

USD value of the closest upcoming unlock (tokens × current price).

Example:

"8125000"

​
vestingType
enum<string>
required

Allocation vesting schedule type.

Available options:
linear,
nonlinear,
dynamic
Example:

"linear"