Upcoming Token Unlocks - Cryptorank API V3

Authorizations

X-Api-Key

string

header

required

Query Parameters

page

number

default:1

Page number (1-based). Returns up to 25 items per page.

Required range: 1 <= x <= 1000

daysAhead

number

default:30

Window for upcoming unlocks in days from today (inclusive).

Required range: 1 <= x <= 365

minUsdAmount

number

Lower bound on the unlock USD value (inclusive).

Example:

1000000

minPercentOfMcap

number

Lower bound on the unlock size as a percent of the coin market capitalization (inclusive). Value is a percent, e.g. 5 means 5%.

Example:

1

sortBy

enum<string>

default:date

Available options:

date,

usdAmount,

percentOfMcap

sortOrder

enum<string>

default:asc

Available options:

asc,

desc

Response

currencyId

number

required

Currency unique numeric identifier.

Example:

28

name

string

required

Display name.

Example:

"Ethereum"

symbol

string | null

required

Native token symbol (e.g. 'ETH', 'BNB'); null when unknown.

Example:

"ETH"

imageUrl

string | null

required

Coin logo (150×150); null when no image is available.

Example:

"https://images.cryptorank.io/coins/150x150.ethereum1524754012028.png"

time

number

required

Unlock date — Unix milliseconds (start of day, UTC). When several events fall on the same day for one coin their token amounts are aggregated into a single entry.

Example:

1780272000000

tokenAmount

string

required

Number of tokens that will be unlocked on time (raw token units).

Example:

"1250000"

usdAmount

string

required

Value of the unlock at the current coin price, USD — tokenAmount × price, rounded to whole dollars.

Example:

"4625000"

percentOfMcap

number

required

Unlock value as a percent of the coin market capitalization (current circulating supply). Example: 0.42 means 0.42%.

Example:

0.42

percentOfSupply

number

required

Unlock token amount as a percent of the coin total supply (max supply with a fallback to total supply). Example: 1.05 means 1.05%.

Example:

1.05

price

string

required

Current coin price, USD (twelve fractional digits).

Example:

"3.70"

marketCap

string

required

Current coin market capitalization, USD, rounded to whole dollars.

Example:

"1100000000"

circulatingSupply

string

required

Current coin circulating supply (raw token units).

Example:

"297000000"