# QuantOracle Crypto Vesting Schedule Calculator

> QuantOracle Crypto Vesting Schedule Calculator is a paid API for AI agents from api.quantoracle.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Computes a month-by-month token vesting schedule given TGE percentage, cliff, linear/custom vesting parameters, and total supply

## Facts

- Endpoint: POST https://api.quantoracle.dev/v1/crypto/vesting-schedule
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-quantoracle-dev-e69b2106
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uvN_3md01c809WTwfu7ZK

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 api-quantoracle-dev-e69b2106 -d '<json body>'
```

Example prompt: Generate a full month-by-month vesting schedule for 1,000,000 tokens starting January 1 2024, with 10% released at TGE, a 12-month cliff, and 36-month linear vesting after that.

## When to prefer this

Use this endpoint when you need a precise, month-granularity token vesting schedule for crypto/DeFi tokenomics modeling — especially when combining TGE unlock, cliff periods, and linear vesting. Prefer over manual spreadsheet calculations or generic financial amortization tools that lack crypto-specific vesting concepts.

## Known failure modes

- Invalid vesting_type enum value returns error
- cliff_months or vesting_months as negative numbers rejected
- tge_pct > 100 causes validation error
- Missing required fields (total_tokens, start_date, vesting_months) returns 400
- start_date in unsupported format causes parse error
- Payment failure (insufficient USDC balance) returns 402

## How this service works

QuantOracle: crypto/vesting-schedule

## Output

Returns an array of monthly schedule entries, each containing the month index, tokens unlocked that month, cumulative tokens unlocked, and percentage unlocked — covering the full vesting period from TGE through final unlock.

## Example request

```json
{
 "cliff_months": 12,
 "total_tokens": 1000000,
 "tge_percentage": 10,
 "vesting_months": 36
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tge_pct": {
   "type": "number",
   "title": "Tge Pct",
   "default": 0,
   "description": "Percentage unlocked at Token Generation Event (0-100)"
  },
  "start_date": {
   "type": "string",
   "title": "Start Date",
   "default": "2025-01-01",
   "description": "Vesting start date (YYYY-MM-DD)"
  },
  "cliff_months": {
   "type": "integer",
   "title": "Cliff Months",
   "default": 0,
   "description": "Cliff period in months"
  },
  "total_tokens": {
   "type": "number",
   "title": "Total Tokens",
   "description": "Total tokens in the vesting grant"
  },
  "vesting_type": {
   "enum": [
    "linear",
    "monthly_cliff",
    "quarterly"
   ],
   "type": "string",
   "title": "Vesting Type",
   "default": "linear",
   "description": "Vesting schedule type"
  },
  "vesting_months": {
   "type": "integer",
   "title": "Vesting Months",
   "default": 24,
   "description": "Total vesting duration in months"
  }
 }
}
```

## More

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