# ChainRay Token Unlock Schedule

> ChainRay Token Unlock Schedule is a paid API for AI agents from chainray.online, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-08).

Returns token unlock schedule and vesting data for a given token contract address on a specified blockchain

## Facts

- Endpoint: GET https://chainray.online/token-unlock/%7Baddress%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-token-unlock-schedule-0f810dad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sMUdf8jkKUVb_qhDyQJ4D

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 chainray-token-unlock-schedule-0f810dad
```

Example prompt: Look up the token unlock schedule for contract address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — I want to see all upcoming vesting events and how many tokens get released on each date.

## When to prefer this

Use this endpoint when you need on-chain token unlock and vesting schedule data for a specific contract address, especially for DeFi research, tokenomics analysis, or monitoring upcoming token release events. Prefer this over generic blockchain explorers when you need structured, agent-consumable vesting data across 46 chains with pay-per-request pricing.

## Known failure modes

- Invalid contract address returns 400 or empty result
- Address is not a token with vesting schedule — no unlock data found
- Unsupported chain specified — 404 or error response
- Payment failure via x402 — 402 response requiring USDC payment
- Rate limiting or upstream data unavailability — 503 or timeout

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

Returns a structured token unlock schedule including vesting event dates, amounts to be unlocked per event, cliff periods, and cumulative unlock percentages for the specified token contract address on the given blockchain network.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "chain": "ethereum",
   "address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984"
  }
 }
}
```

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network"
      },
      "address": {
       "type": "string",
       "description": "Wallet or contract address"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-token-unlock-schedule-0f810dad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)