---
title: "Get Supply Unlocks"
method: GET
path: "/api/v1/supply/unlocks"
tags: ["Token Supply"]
---

# Get Supply Unlocks

`GET /api/v1/supply/unlocks`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/supply/unlocks`
- Auth: API key in header `X-API-Key`

The forward token-unlock calendar — dated vesting cliffs.

Sourced from DefiLlama's free emissions data and sized against the coin's own
float, so a cliff reads as "12% of circulating supply on 1 Sept" rather than
a raw token count.

**This is a cliff calendar, not an emissions feed.** Continuous emission is
deliberately excluded: mining inflation, linear vesting, and runs of
identical daily releases are a drip, not a step, and publishing them as
catalysts buries the real ones. Coverage is bounded by the protocols
DefiLlama tracks — absence here is not evidence that a token has no unlock.

Free tier is limited to the next 7 days; Pro and above get the full horizon. Each coin
lists its SOONEST cliff only. ``limit`` (added 2026-10-10; it used to be ignored) caps
the rows; an unrecognised query parameter is a 400.

## Query parameters

- `window_days` integer: Forward horizon
- `symbol` string, nullable: Filter to one ticker. A Hyperliquid k-name (kBONK) finds BONK.
- `limit` integer, nullable: At most this many rows, soonest first

## Response `200`

Successful Response

- SupplyUnlocksResponse
  - `items` SupplyUnlockItem[], required
    - `symbol` string, required
    - `name` string, required
    - `coingecko_id` string, nullable
    - `date` string, required
    - `days_until` integer, required
    - `tokens` number, nullable
    - `usd` number, nullable
    - `pct_of_float` number, nullable
    - `pct_of_market_cap` number, nullable
    - `categories` string[]
    - `float_pct` number, required
    - `market_cap` number, nullable
  - `count` integer, required
  - `window_days` integer, required
  - `tier_scope` string, required
  - `as_of` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)