# unlock-next

> unlock-next is a paid API for AI agents from payai.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 given crypto asset, plus its emission velocity over 24h, 7d, 30d, and 1y periods.

## Facts

- Endpoint: GET https://payai.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/unlock-next-48c051fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Gp_i4y-MjIEf5pXR-UAEM

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-next-48c051fc
```

Example prompt: What's the next scheduled token unlock for ARB — give me the date, amount, USD value, percentage of circulating supply, unlock type, and the emission velocity over the last 7 days and 30 days.

## When to prefer this

Choose this endpoint when you need only the single next unlock event for a specific token and want the cheapest possible signal — it avoids the overhead of full unlock schedule endpoints. Ideal for quick pre-trade sell-pressure checks, portfolio monitoring triggers, or tokenomics research where only the immediate next event matters. Prefer this over broader schedule endpoints when latency and cost are priorities and you don't need the full historical or future unlock calendar.

## Known failure modes

- Unknown ticker/name/slug returns an error or empty result if the token is not tracked by DeFiLlama emissions
- No upcoming unlock scheduled returns null or empty unlock fields if the token has no future unlocks on record
- Ambiguous input (e.g. common ticker collision) may return data for the wrong token
- Stale or delayed data from DeFiLlama if the upstream source has not updated recently
- Missing at least one of ticker, name, or slug results in a bad request 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

A structured JSON response containing the next scheduled unlock event details (date, token amount, USD value, percent of circulating supply, unlock type) and the token's emission velocity metrics across four time windows (24h, 7d, 30d, 1y), with DeFiLlama cited as the data source.

## 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/unlock-next-48c051fc/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)