# unlock-upcoming

> unlock-upcoming is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns a market-wide screener of the largest upcoming token unlocks across crypto protocols, ranked by USD value or percent of circulating supply, within a configurable forward time window.

## Facts

- Endpoint: GET https://payai.agentstools.dev/unlock/upcoming
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/unlock-upcoming-e2ccfb00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DhFZOcSMSw-sFl_T8IoCx

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 unlock-upcoming-e2ccfb00
```

Example prompt: Show me 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 coming up.

## When to prefer this

Choose this endpoint when you need a forward-looking, market-wide view of scheduled token unlock events ranked by economic impact (USD value or circulating supply percentage). It is ideal for pre-trade risk checks, DeFi research, and identifying potential sell-pressure catalysts. It covers many tokens simultaneously rather than requiring per-token queries, and data is sourced from DeFiLlama for credibility. Prefer it over manual on-chain analysis or single-token vesting trackers when you need a broad screener sorted by magnitude.

## Known failure modes

- Invalid rank_by value (must be 'usd_value' or 'pct_float') returns a validation error
- window_days outside 1–1825 range returns a schema validation error
- limit outside 1–25 range is rejected
- Upstream DeFiLlama data unavailability may result in stale or empty results
- Payment failure (x402 protocol) if USDC balance is insufficient

## 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 including the token name, protocol, scheduled unlock date, token amount to be released, estimated USD value of the unlock, and the unlock size as a percent of circulating supply. Results are bounded to the requested limit and sorted by the chosen ranking method (USD value or percent of 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/unlock-upcoming-e2ccfb00/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)