Docs menu

CoinGecko API endpoint

CoinGecko Token Unlocks API

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.

GETapiKey2 credits/requestCoinGeckocoingecko.tokenUnlocksResponseDoc/coingecko/token-unlocks

Endpoint facts

Method: GET
API path: /coingecko/token-unlocks
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.tokenUnlocksResponseDoc

CoinGecko scraping API Try CoinGecko Token Unlocks API in Playground CoinGecko API documentation

How this endpoint behaves

Returns incoming token unlock rows from CoinGecko.

Path parameters: none.

Query parameters:

limit: optional row limit. Default 100, maximum 100.

Notable response behavior:

Rows include coin identity, link, image, price, percentage changes, market cap, released percent, next unlock values, and countdown text when present.
Empty or malformed table shapes without a clear empty-state marker return upstream errors.

Live monitoring

Monitored request: GET /coingecko/token-unlocks?limit=3
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/token-unlocks?limit=20
Items in coins: 18
Fields filled in every checked item: 15
Fields empty in some or all items: 2

Field	Filled in, of 18 checked	Values in the sample
rank	18	23 to 6,053, median 462
id	18
symbol	18	“FUN” and 17 other values
name	18	“Sport Fun” and 17 other values
url	18	coingecko.com
image_url	18	assets.coingecko.com
price	18	0 to 1.92, median 0.06
change_1h_percent	18	0 to 1.7, median 0.4
change_24h_percent	18	0.1 to 100, median 4.8
change_7d_percent	18	0.44 to 62.3, median 10.9
market_cap	18	87,604.95 to 5,197,358,214, median 24,004,359
released_percent	17	9.76 to 100, median 32.65
next_unlock_amount	18	3,400,000 to 1,200,000,000, median 23,000,000
next_unlock_symbol	18	“FUN” and 17 other values
next_unlock_value_usd	18	725.13 to 195,041,000, median 1,496,000
next_unlock_percent	15	0.22 to 26.76, median 3.4
next_unlock_time_left	18	0 Days 0 Hrs 0 Min 0 Sec in all 18

Request parameters

Parameter	Type	Required	Default	Description	Example
limit	integer	No		Rows to return, default 100, max 100
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/token-unlocks?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "limit": 100,
    "source_url": "https://www.coingecko.com/en/highlights/incoming-token-unlocks",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "solv-protocol",
        "symbol": "SOLV",
        "name": "Solv Protocol",
        "url": "https://www.coingecko.com/en/coins/solv-protocol",
        "price": 0.071,
        "change_1h_percent": 0.2,
        "change_24h_percent": 1.4,
        "change_7d_percent": -2.1,
        "market_cap": 101000000,
        "released_percent": 45.2,
        "next_unlock_amount": 4800000,
        "next_unlock_symbol": "SOLV",
        "next_unlock_value_usd": 336730,
        "next_unlock_percent": 0.28,
        "next_unlock_time_left": "0 Days 09 Hrs 16 Min 49 Sec"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.tokenUnlocksResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.TokenUnlocksResponse	No
data.coins	array	No		Coins with upcoming token unlocks.
data.coins[].change_1h_percent	number	No	0.2	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	1.4	Price change over the last 24 hours, in percent.
data.coins[].change_7d_percent	number	No	-2.1	Price change over the last 7 days, in percent.
data.coins[].id	string	No	solv-protocol	CoinGecko coin id.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/standard/solv.png	URL of the coin logo.
data.coins[].market_cap	number	No	101000000	Market capitalisation of the coin.
data.coins[].name	string	No	Solv Protocol	Name of the coin.
data.coins[].next_unlock_amount	number	No	4800000	Number of tokens in the next unlock.
data.coins[].next_unlock_percent	number	No	0.28	Size of the next unlock, in percent.
data.coins[].next_unlock_symbol	string	No	SOLV	Ticker symbol of the token being unlocked.
data.coins[].next_unlock_time_left	string	No	0 Days 09 Hrs 16 Min 49 Sec	Time left until the next unlock as CoinGecko displays it, for example `0 Days 09 Hrs 16 Min 49 Sec`.
data.coins[].next_unlock_value_usd	number	No	336730	Value of the next unlock, in US dollars.
data.coins[].price	number	No	0.071	Current price of the coin.
data.coins[].rank	integer	No	1	Position of the coin in the token unlocks table.
data.coins[].released_percent	number	No	45.2	Share of the token supply already released, in percent.
data.coins[].symbol	string	No	SOLV	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/solv-protocol	Link to the coin page on CoinGecko.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	100	Maximum number of coins returned.
data.source_url	string	No	https://www.coingecko.com/en/highlights/incoming-token-unlocks	URL the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/token-unlocks?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More CoinGecko endpoint docs CoinGecko scraping API CoinGecko categories API documentation CoinGecko Category Coins API documentation CoinGecko chains API documentation CoinGecko Chain API documentation CoinGecko Coin API documentation CoinGecko Coin Analysis API documentation

Open in Playground Back to group

Docs menu

CoinGecko API endpoint

CoinGecko Token Unlocks API

GETapiKey2 credits/requestCoinGeckocoingecko.tokenUnlocksResponseDoc/coingecko/token-unlocks

Endpoint facts

Method: GET
API path: /coingecko/token-unlocks
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: CoinGecko
Response schema: #/definitions/coingecko.tokenUnlocksResponseDoc

CoinGecko scraping API Try CoinGecko Token Unlocks API in Playground CoinGecko API documentation

How this endpoint behaves

Returns incoming token unlock rows from CoinGecko.

Path parameters: none.

Query parameters:

limit: optional row limit. Default 100, maximum 100.

Notable response behavior:

Rows include coin identity, link, image, price, percentage changes, market cap, released percent, next unlock values, and countdown text when present.
Empty or malformed table shapes without a clear empty-state marker return upstream errors.

Live monitoring

Monitored request: GET /coingecko/token-unlocks?limit=3
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /coingecko/token-unlocks?limit=20
Items in coins: 18
Fields filled in every checked item: 15
Fields empty in some or all items: 2

Field	Filled in, of 18 checked	Values in the sample
rank	18	23 to 6,053, median 462
id	18
symbol	18	“FUN” and 17 other values
name	18	“Sport Fun” and 17 other values
url	18	coingecko.com
image_url	18	assets.coingecko.com
price	18	0 to 1.92, median 0.06
change_1h_percent	18	0 to 1.7, median 0.4
change_24h_percent	18	0.1 to 100, median 4.8
change_7d_percent	18	0.44 to 62.3, median 10.9
market_cap	18	87,604.95 to 5,197,358,214, median 24,004,359
released_percent	17	9.76 to 100, median 32.65
next_unlock_amount	18	3,400,000 to 1,200,000,000, median 23,000,000
next_unlock_symbol	18	“FUN” and 17 other values
next_unlock_value_usd	18	725.13 to 195,041,000, median 1,496,000
next_unlock_percent	15	0.22 to 26.76, median 3.4
next_unlock_time_left	18	0 Days 0 Hrs 0 Min 0 Sec in all 18

Request parameters

Parameter	Type	Required	Default	Description	Example
limit	integer	No		Rows to return, default 100, max 100
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/coingecko/token-unlocks?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "limit": 100,
    "source_url": "https://www.coingecko.com/en/highlights/incoming-token-unlocks",
    "fetched_at": "2026-05-24T00:00:00Z",
    "coins": [
      {
        "rank": 1,
        "id": "solv-protocol",
        "symbol": "SOLV",
        "name": "Solv Protocol",
        "url": "https://www.coingecko.com/en/coins/solv-protocol",
        "price": 0.071,
        "change_1h_percent": 0.2,
        "change_24h_percent": 1.4,
        "change_7d_percent": -2.1,
        "market_cap": 101000000,
        "released_percent": 45.2,
        "next_unlock_amount": 4800000,
        "next_unlock_symbol": "SOLV",
        "next_unlock_value_usd": 336730,
        "next_unlock_percent": 0.28,
        "next_unlock_time_left": "0 Days 09 Hrs 16 Min 49 Sec"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/coingecko.tokenUnlocksResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	coingecko.TokenUnlocksResponse	No
data.coins	array	No		Coins with upcoming token unlocks.
data.coins[].change_1h_percent	number	No	0.2	Price change over the last hour, in percent.
data.coins[].change_24h_percent	number	No	1.4	Price change over the last 24 hours, in percent.
data.coins[].change_7d_percent	number	No	-2.1	Price change over the last 7 days, in percent.
data.coins[].id	string	No	solv-protocol	CoinGecko coin id.
data.coins[].image_url	string	No	https://assets.coingecko.com/coins/images/standard/solv.png	URL of the coin logo.
data.coins[].market_cap	number	No	101000000	Market capitalisation of the coin.
data.coins[].name	string	No	Solv Protocol	Name of the coin.
data.coins[].next_unlock_amount	number	No	4800000	Number of tokens in the next unlock.
data.coins[].next_unlock_percent	number	No	0.28	Size of the next unlock, in percent.
data.coins[].next_unlock_symbol	string	No	SOLV	Ticker symbol of the token being unlocked.
data.coins[].next_unlock_time_left	string	No	0 Days 09 Hrs 16 Min 49 Sec	Time left until the next unlock as CoinGecko displays it, for example `0 Days 09 Hrs 16 Min 49 Sec`.
data.coins[].next_unlock_value_usd	number	No	336730	Value of the next unlock, in US dollars.
data.coins[].price	number	No	0.071	Current price of the coin.
data.coins[].rank	integer	No	1	Position of the coin in the token unlocks table.
data.coins[].released_percent	number	No	45.2	Share of the token supply already released, in percent.
data.coins[].symbol	string	No	SOLV	Ticker symbol of the coin.
data.coins[].url	string	No	https://www.coingecko.com/en/coins/solv-protocol	Link to the coin page on CoinGecko.
data.fetched_at	string	No	2026-05-24T00:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.limit	integer	No	100	Maximum number of coins returned.
data.source_url	string	No	https://www.coingecko.com/en/highlights/incoming-token-unlocks	URL the data was read from.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/coingecko/token-unlocks?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

CoinGecko Token Unlocks API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

CoinGecko Token Unlocks API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related