# Crypto Token Unlock Screener

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

Returns a ranked list of the largest upcoming token unlock events across the crypto market, sorted by USD value or percent of circulating supply, with unlock dates, token amounts, and protocol names.

## Facts

- Endpoint: GET https://api.agentstools.dev/unlock/upcoming
- Price: $0.05/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-screener-ea2959de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-CcX3J-cWyYTbrgOwHmzS

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-screener-ea2959de
```

Example prompt: Pull the top 15 upcoming token unlocks over the next 60 days, ranked by USD value — I want to see which protocols have the biggest scheduled releases hitting the market.

## When to prefer this

Use this endpoint when you need a broad market-wide view of upcoming token unlock events rather than data for a single specific token. Ideal for portfolio risk analysis, trading signals, or market timing research. Prefer this over manual DeFiLlama browsing when you want programmatic, ranked, structured data you can filter by time window and sort by impact metric.

## Known failure modes

- Invalid rank_by value — must be 'usd_value' or 'pct_float'; returns 400 error
- window_days out of range (1–1825); returns 400 validation error
- limit out of range (1–25); returns 400 validation error
- Upstream DeFiLlama data unavailable or stale; may return 503 or degraded data
- Payment not attached or insufficient; returns 402 requiring x402 payment of $0.05 USDC

## How this service works

Market-wide screener of the biggest upcoming token unlocks across many crypto tokens in a forward window. Returns the largest scheduled unlocks ranked by USD value or by percent of circulating supply, each with its date, token amount and protocol. Bounded fan-out across the most active emitters. Data from DeFiLlama, cited.

## Output

A ranked list of upcoming token unlock events, each entry containing the token/protocol name, scheduled unlock date, token amount to be unlocked, USD value of the unlock, and its percentage of circulating supply, ordered by the chosen ranking metric (usd_value or pct_float).

## 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": {
      "limit": {
       "type": "integer",
       "maximum": 25,
       "minimum": 1,
       "description": "Max rows to return, default 25"
      },
      "rank_by": {
       "enum": [
        "usd_value",
        "pct_float"
       ],
       "type": "string",
       "description": "Rank by unlock USD value or percent of circulating"
      },
      "window_days": {
       "type": "integer",
       "maximum": 1825,
       "minimum": 1,
       "description": "Forward window in days, default 90"
      }
     }
    }
   },
   "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-screener-ea2959de/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)