# Upcoming Token Unlock Data Feed

> Upcoming Token Unlock Data Feed is a paid API for AI agents from x402helper.xyz, paid per call via x402, $0.065/call, status unknown (last checked 2026-10-31).

Returns ranked data on upcoming cryptocurrency token unlock events within a configurable forward time window

## Facts

- Endpoint: GET https://x402helper.xyz/89e509/unlock/upcoming?utm_source=zero.xyz
- Price: $0.065/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/upcoming-token-unlock-data-feed-80f299cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zLyuxKQb2uZ3ghWIgfoSh

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 upcoming-token-unlock-data-feed-80f299cc
```

Example prompt: Show me the top 15 upcoming token unlocks over the next 60 days, ranked by USD value.

## When to prefer this

Use this endpoint when you need structured, ranked data on upcoming cryptocurrency token unlock and vesting events within a configurable time window. It is particularly useful for crypto traders, analysts, or DeFi protocols that want to anticipate market sell pressure or circulating supply changes. Prefer this over manual research or generic data aggregators when you need machine-readable, ranked unlock data payable via USDC micropayment.

## Known failure modes

- Invalid rank_by enum value returns an error
- window_days out of range (1-1825) returns validation error
- limit out of range (1-25) returns validation error
- Payment not processed results in 402 response requiring USDC micropayment
- Empty result set if no unlocks found in specified window

## How this service works

X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.

## Output

A JSON object with a success flag and a result containing ranked token unlock events, including details like token name, unlock date, USD value of unlocking tokens, and percentage of circulating supply affected, filtered by the specified window and limit.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "default": null,
       "maximum": 25,
       "minimum": 1,
       "description": "Max rows to return, default 25"
      },
      "rank_by": {
       "enum": [
        "usd_value",
        "pct_float"
       ],
       "type": "string",
       "default": null,
       "description": "Rank by unlock USD value or percent of circulating"
      },
      "window_days": {
       "type": "integer",
       "default": null,
       "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/upcoming-token-unlock-data-feed-80f299cc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402helper.xyz](https://www.zero.xyz/host/x402helper.xyz/llms.txt)