Skip to main content
GET
/
v3
/
token-unlocks
/
upcoming
Upcoming token unlocks across all coins
curl --request GET \
  --url https://api.cryptorank.io/v3/token-unlocks/upcoming \
  --header 'X-Api-Key: <api-key>'
[
  {
    "currencyId": 28,
    "currencyName": "Ethereum",
    "currencySymbol": "ETH",
    "currencyImages": {
      "icon": "<string>",
      "x60": "<string>",
      "x150": "<string>",
      "native": "<string>"
    },
    "date": "2026-06-01T00:00:00.000Z",
    "tokenAmount": "1250000",
    "usdAmount": "4625000",
    "percentOfMcap": 0.42,
    "percentOfSupply": 1.05,
    "price": "3.70",
    "marketCap": "1100000000",
    "circulatingSupply": "297000000"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Api-Key
string
header
required

Query Parameters

offset
number
default:0
Required range: 0 <= x <= 50000
limit
number
default:50
Required range: 1 <= x <= 200
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

200 - application/json
currencyId
number
required

Coin identifier in cryptorank.

Example:

28

currencyName
string
required
Example:

"Ethereum"

currencySymbol
string | null
required
Example:

"ETH"

currencyImages
object
required

Coin logo URLs in all available sizes.

date
string
required

Date of the upcoming unlock (ISO 8601 UTC, time component fixed to 00:00:00.000Z). When several events fall on the same day for one coin their token amounts are aggregated into a single entry.

Example:

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

tokenAmount
string
required

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

Example:

"1250000"

usdAmount
string
required

USD value of the unlock — tokenAmount * price, rounded to whole dollars.

Example:

"4625000"

percentOfMcap
number
required

Unlock token amount as a percent of the coin 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 in USD, twelve fractional digits.

Example:

"3.70"

marketCap
string
required

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

Example:

"1100000000"

circulatingSupply
string
required

Current coin circulating supply (raw token units).

Example:

"297000000"