# HALOWERK kettenwerk Token Unlock Schedule Lookup

> HALOWERK kettenwerk Token Unlock Schedule Lookup is a paid API for AI agents from kette.halowerk.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Returns scheduled token unlock/release events for a crypto asset within a caller-specified window of up to 365 days, including on-chain enforcement status and float percentage.

## Facts

- Endpoint: POST https://kette.halowerk.com/token/unlocks
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-unlock-schedule-lookup-974ed562
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dA91SgDPRNlohWF6LuppE

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 halowerk-kettenwerk-token-unlock-schedule-lookup-974ed562 -d '<json body>'
```

Example prompt: Pull the token unlock schedule for ARB from kettenwerk over the next 180 days and tell me how much of the circulating float is being released and whether those unlocks are enforced on-chain.

## When to prefer this

Use this endpoint when you need precise, decimal-accurate token unlock schedules with on-chain enforcement metadata for a specific crypto asset over a defined calendar window. It is preferable to generic market data APIs when you need vesting schedule revision history, lock object counts, and on-chain vs off-chain enforcement status — details that CoinGecko or CoinMarketCap do not surface.

## Known failure modes

- Ambiguous token symbol returns an error asking for a more specific slug
- Unknown asset slug or symbol returns a not-found error
- Requested window exceeds 365 days returns a validation error
- CoinGecko unavailable when no circulating_supply provided may delay or fail the float percentage calculation
- No unlock data indexed for a given asset returns an empty events list

## How this service works

Looks up a crypto asset by its exact NetSupply slug or an unambiguous symbol, then returns the scheduled releases inside a caller-selected window of up to 365 days. Unlock amounts remain decimal strings so large token quantities are not rounded. Each event states whether the schedule is enforced on-chain, how many lock objects it combines, when the promise was first recorded and how often it was revised. The percentage of float uses current circulating supply from CoinGecko, or a caller-supplied

## Output

A list of scheduled token unlock/release events within the requested window, each containing the unlock date, token amount as a decimal string, whether the schedule is enforced on-chain, the number of lock objects combined, the date the schedule was first recorded, the number of revisions, and the percentage of circulating float being unlocked (sourced from CoinGecko or caller-supplied supply).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "default": 90,
   "maximum": 365,
   "minimum": 1,
   "description": "Calendar window from today in UTC, inclusive. Default 90 days."
  },
  "asset": {
   "type": "string",
   "maxLength": 80,
   "minLength": 1,
   "description": "Exact NetSupply slug such as \"xrp\" or an unambiguous token symbol such as \"XRP\"."
  },
  "circulating_supply": {
   "type": "number",
   "description": "Optional current circulating supply. When omitted, CoinGecko is used. The response always identifies which basis was used.",
   "exclusiveMinimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-token-unlock-schedule-lookup-974ed562/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.halowerk.com](https://www.zero.xyz/host/kette.halowerk.com/llms.txt)