# SignalHarness Token Unlock Calculator

> SignalHarness Token Unlock Calculator is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Calculates token unlock schedules and vesting details based on caller-supplied token unlock request data.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/token_unlock_calculate/invoke
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-token-unlock-calculator-1e62d80e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E1NFnL_CTqJXojoRqbQZM

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 signalharness-token-unlock-calculator-1e62d80e -d '<json body>'
```

Example prompt: Can you calculate the token unlock schedule from this vesting agreement text: '10M tokens, 12-month cliff, then linear monthly unlocks over 36 months starting Jan 1 2024'?

## When to prefer this

Choose this endpoint when you need to programmatically compute or interpret token vesting and unlock schedules from natural language or structured descriptions, especially in agent workflows dealing with crypto token grants, DeFi allocations, or investor agreements. It is purpose-built for agent-native use with micropayment access at $0.01 per call, making it cost-effective for on-demand calculations without a subscription.

## Known failure modes

- Malformed or ambiguous token_unlock_request string may produce warnings or empty calculations
- Request string too short (< 2 chars) or too long (> 65536 chars) will fail validation
- Insufficient or unclear vesting terms in the input may result in incomplete calculations with warnings
- Payment failure on the x402 micropayment layer will prevent execution
- Service may return warnings array with issues found in the supplied data without fully failing

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a JSON object containing the computed token unlock calculation result, any warnings about the supplied data, an evidence scope indicator (always 'caller_supplied_data'), and standard receipt metadata including payment ID, request ID, execution timing, and a SHA-256 hash of the result for verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token_unlock_request": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "The service does not verify legal entitlement or contract state."
   ],
   "service_id": "token_unlock_calculate",
   "evidence_scope": "caller_supplied_data",
   "token_unlock_calculation": "{\"at_ms\":1700000000500,\"grants\":[{\"id\":\"g1\",\"total_atomic\":\"1000\",\"unvested_atomic\":\"500\",\"vested_atomic\":\"500\",\"vested_percent\":\"50\"}],\"locked_atomic\":\"500\",\"unlocked_atomic\":\"500\"}"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "token_unlock_calculate",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "10000",
   "resultSha256": "5c855768b6efc295ba29cf5cb5504fd16744c70a5189297282a9d4f9835ea5f8",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-token-unlock-calculator-1e62d80e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)