Vesting & Token Unlocks

Unlock Events

Description

Chronological list of token unlock events for a currency.

Note: Filterable by all / upcoming / past. Amounts are in the project's native token; USD figures use the current price.

Access

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

Request

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

Path parameters

idinteger required
Example:1

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

Query parameters

pagenumber

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

filter'all' | 'upcoming' | 'past'

Limit events to upcoming or past ones, or return the full history.

sortBy'time' | 'unlockValue' | 'percentOfMcap'

Sort field.

sortOrder'asc' | 'desc'

Sort direction.

convert'EUR' | 'USD'

Fiat currency for unlock-value conversion (default USD).

Response

Example response

{
  "data": [
    {
      "allocationId": 17132,
      "allocationName": "Private Sale Investors",
      "cumulativeUnlockedPercent": 84,
      "cumulativeUnlockedTokens": "527400000",
      "cumulativeUnlockedValue": "36370000000",
      "percentOfAllocation": 1.37,
      "percentOfMcap": 0.42,
      "percentOfSupply": 0.08,
      "time": 1715000000000,
      "unlockTokens": "125000",
      "unlockValue": "462500"
    }
  ],
  "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.