Vesting & Token Unlocks

Upcoming Token Unlocks

Description

Returns upcoming unlocks across all coins.

Tip: For a single coin's full unlock schedule use /currencies/:id/vesting/events.

Access

  • Available from: Pro
  • Cost: 1 credit per request
get/v3/currencies/upcoming-token-unlocks

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/currencies/upcoming-token-unlocks
  • Auth: API key in header X-Api-Key

Query parameters

pagenumber

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

daysAheadnumber

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

minValuenumber
Example:1000000

Lower bound on the unlock USD value (inclusive).

minPercentOfMcapnumber
Example:1

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

sortBy'id' | 'date' | 'unlockValue' | 'percentOfMcap'

Sort field.

sortOrder'asc' | 'desc'

Sort direction.

Response

Example response

{
  "data": [
    {
      "circulatingSupply": "297000000",
      "id": 28,
      "imageUrl": "https://images.cryptorank.io/coins/150x150.ethereum1524754012028.png",
      "marketCap": "1100000000",
      "name": "Ethereum",
      "percentOfMcap": 0.42,
      "percentOfSupply": 1.05,
      "price": "3.70",
      "symbol": "ETH",
      "time": 1780272000000,
      "unlockTokens": "1250000",
      "unlockValue": "4625000"
    }
  ],
  "meta": {
    "hasNextPage": true,
    "page": 1,
    "pageSize": 25
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

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