# Crypto Token Unlock & Vesting Calendar

> Crypto Token Unlock & Vesting Calendar is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns forward-looking token unlock and vesting schedule for a single crypto token, including next unlock details, full upcoming cliff/linear unlocks, allocation breakdown, supply metrics, and a 0-100 supply-overhang score.

## Facts

- Endpoint: GET https://api.agentstools.dev/unlock/calendar
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-token-unlock-vesting-calendar-528ac544
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4dDN2c2_JPq-iU_Q4HSbP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability crypto-token-unlock-vesting-calendar-528ac544
```

Example prompt: Can you pull up the token unlock calendar for ARB (Arbitrum) over the next 180 days — I want to see the next unlock date and amount, the full schedule of cliff and linear events, how supply is split between team, investors, and community, and what the supply-overhang score looks like?

## When to prefer this

Use this endpoint when you need structured, forward-looking tokenomics data — particularly unlock schedules, vesting timelines, and supply-overhang risk scores — for a specific crypto token. It is the right choice over generic price APIs or news feeds when the user is asking about supply dilution risk, upcoming unlock events, or allocation splits. Prefer this over on-chain data scrapers when you need a normalized, scored summary rather than raw contract data.

## Known failure modes

- Token not found by ticker/name/slug — returns 404 or empty result if DeFiLlama has no emissions data for that token
- Ambiguous ticker matches multiple tokens — may need slug for disambiguation
- No upcoming unlocks in the requested window — returns empty unlock list
- window_days out of range (must be 1-1825) — returns 422 validation error
- Missing required identifier (no name, slug, or ticker provided) — returns 400 bad request

## How this service works

Forward-looking token unlock and vesting calendar for one crypto token. Give a ticker, name or slug and get the next unlock (date, token amount, USD value, percent of circulating supply), the full list of upcoming cliff and linear unlocks in a window, the allocation split across team, investors, ecosystem and community, supply metrics and a deterministic 0-100 supply-overhang score. Data from DeFiLlama, cited.

## Output

Returns a structured payload containing: the next scheduled unlock with date, token amount, USD value, and percent of circulating supply; a full list of upcoming cliff and linear unlock events within the requested window; an allocation breakdown across team, investors, ecosystem, and community buckets; key supply metrics; and a deterministic 0-100 supply-overhang score. Data is sourced from DeFiLlama.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "name": {
       "type": "string",
       "description": "Protocol name, e.g. Arbitrum"
      },
      "slug": {
       "type": "string",
       "description": "DeFiLlama emissions slug, e.g. arbitrum"
      },
      "ticker": {
       "type": "string",
       "description": "Token ticker symbol, e.g. ARB"
      },
      "window_days": {
       "type": "integer",
       "maximum": 1825,
       "minimum": 1,
       "description": "Forward window for upcoming unlocks, default 365"
      },
      "include_backtest": {
       "type": "boolean",
       "description": "Include price response to past unlocks (default false)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-token-unlock-vesting-calendar-528ac544/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)