---
title: "Forward token-unlock calendar"
method: GET
path: "/crypto/unlocks"
tags: ["crypto"]
---

# Forward token-unlock calendar

`GET /crypto/unlocks`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/crypto/unlocks`
- Auth: HTTP bearer

Forward calendar of scheduled token-unlock tranches from token_unlock_schedules. Filter by symbol and a forward horizon (≤ 365d, default 90). Each tranche carries amount_tokens, pct_of_supply, category (team|investor|foundation|ecosystem|community|other), cliff, source_url, source_kind, and verified_at.

Coverage is HAND-CURATED from PRIMARY sources only (foundation docs / official governance / on-chain vesting) — no aggregators. Each tranche is gated on verified_at freshness: rows not re-verified within 120 days are flagged `stale` (surfaces degrade them). `meta.coverage` lists the curated symbol universe; `as_of` is the newest verification time.

## Query parameters

- `symbol` string, nullable: Restrict to one symbol (uppercased).
- `days` integer: Forward horizon in days.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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