# BlockRun.AI Token Unlock Schedule & Vesting

> BlockRun.AI Token Unlock Schedule & Vesting is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.0075/call, status unknown (last checked 2026-09-13).

Returns the token unlock schedule and vesting details for a cryptocurrency token, including release timelines and tokenomics data.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/surf/token/tokenomics
- Price: $0.0075/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-b08ac52f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CmXbaIlTs55zEhOC1_Lsn

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 blockrun-ai-b08ac52f
```

Example prompt: Can you pull up the token unlock schedule and vesting details for the ARB token so I can see when major unlocks are happening and how much supply is being released?

## When to prefer this

Use this endpoint when you need structured token vesting and unlock schedule data for a specific cryptocurrency, especially when researching upcoming supply unlocks that may affect token price or market dynamics. Prefer this over general market data endpoints when the specific question is about future token release schedules rather than current price or volume.

## Known failure modes

- Token not found or unsupported — returns empty or error response
- Invalid token symbol/address — returns 400 or null data object
- Network timeout — no response or partial data
- Token has no tracked vesting schedule — returns empty data
- Rate limit exceeded — 429 response

## How this service works

Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.

## Output

Returns structured tokenomics data including token unlock schedules, vesting tranches, cliff dates, linear release timelines, percentages of total supply unlocked over time, and upcoming release events for the queried token.

## Example request

```json
{
 "input": {
  "body": {
   "symbol": "BTC"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-b08ac52f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)