# Crypto Token Next Unlock Lookup

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

Returns the single next scheduled token unlock event for a crypto token, including date, amount, USD value, percent of circulating supply, unlock type, and recent emission velocity.

## Facts

- Endpoint: GET https://api.agentstools.dev/unlock/next
- Price: $0.008/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-next-unlock-lookup-299b1877
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1lEVOl8EwMNa3hssaCdBW

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-next-unlock-lookup-299b1877
```

Example prompt: What's the next scheduled token unlock for ARB — give me the date, how many tokens, the USD value, and what percentage of circulating supply that represents?

## When to prefer this

Use this endpoint when you need a single, lightweight actionable signal about the next token unlock event for a specific crypto project, rather than a full vesting schedule or historical data. Ideal for portfolio monitoring, investment timing research, or alerting workflows where only the immediate next event matters. Prefer this over full unlock schedule endpoints when cost efficiency matters ($0.008/call) and the agent only needs the nearest upcoming event plus emission velocity context.

## Known failure modes

- Token not found in DeFiLlama emissions database — returns error or empty result
- Ambiguous ticker/name matches multiple tokens — may require slug disambiguation
- No future unlocks scheduled — endpoint may return null or empty next unlock
- DeFiLlama data unavailable or stale — upstream data dependency failure
- Invalid or misspelled ticker/name/slug — returns not found error

## How this service works

The single next token unlock for one crypto token, cheapest actionable signal. Give a ticker, name or slug and get just the next scheduled unlock (date, token amount, USD value, percent of circulating supply, unlock type) plus the token's recent emission velocity over 24 hours, 7 days, 30 days and one year. Data from DeFiLlama, cited.

## Output

Returns the next scheduled unlock event for the specified token including: unlock date, token amount being unlocked, USD value at current price, percentage of circulating supply, unlock type (e.g. cliff, linear vesting), plus emission velocity metrics over 24h, 7d, 30d, and 1y periods. Data is sourced from DeFiLlama.

## 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": {
      "name": {
       "type": "string",
       "description": "Protocol name, e.g. Arbitrum"
      },
      "slug": {
       "type": "string",
       "description": "DeFiLlama emissions slug, e.g. arbitrum"
      },
      "ticker": {
       "type": "string",
       "description": "Token ticker symbol, e.g. ARB"
      }
     }
    }
   },
   "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-next-unlock-lookup-299b1877/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)