---
title: "CoinGecko incoming token unlocks"
method: GET
path: "/coingecko/token-unlocks"
tags: ["CoinGecko"]
---

# CoinGecko incoming token unlocks

`GET /coingecko/token-unlocks`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/coingecko/token-unlocks`
- Auth: API key in header `x-api-key`

Returns CoinGecko's list of upcoming token unlocks, up to 100 rows. Each row has the coin's name, symbol, rank, price, 1-hour, 24-hour and 7-day change and market cap, the share of supply already released, and the next unlock's amount, percentage, USD value and time remaining.

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CoingeckoTokenUnlocksResponseDoc
  - `code` integer
  - `data` CoingeckoTokenUnlocksResponse
    - `coins` CoingeckoTokenUnlockRow[]: Coins with upcoming token unlocks.
      - `change_1h_percent` number: Price change over the last hour, in percent.
      - `change_24h_percent` number: Price change over the last 24 hours, in percent.
      - `change_7d_percent` number: Price change over the last 7 days, in percent.
      - `id` string: CoinGecko coin id.
      - `image_url` string: URL of the coin logo.
      - `market_cap` number: Market capitalisation of the coin.
      - `name` string: Name of the coin.
      - `next_unlock_amount` number: Number of tokens in the next unlock.
      - `next_unlock_percent` number: Size of the next unlock, in percent.
      - `next_unlock_symbol` string: Ticker symbol of the token being unlocked.
      - `next_unlock_time_left` string: Time left until the next unlock as CoinGecko displays it, for example `0 Days 09 Hrs 16 Min 49 Sec`.
      - `next_unlock_value_usd` number: Value of the next unlock, in US dollars.
      - `price` number: Current price of the coin.
      - `rank` integer: Position of the coin in the token unlocks table.
      - `released_percent` number: Share of the token supply already released, in percent.
      - `symbol` string: Ticker symbol of the coin.
      - `url` string: Link to the coin page on CoinGecko.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of coins returned.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)