Token vesting unlock calculator API

Compute unlocked vs locked tokens for a linear vesting schedule with a cliff: unlocked = total·min(1, elapsed/vesting) once elapsed >= cliff, else 0 — plus percent unlocked and USD values. Deterministic schedule math. Answers 'how many tokens unlocked at month 12','am I past the cliff','locked supply value'.

Price$0.01per request

MethodPOST

Route/v1/calc/cryptocalc-token-vesting-unlock

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calccryptovestingunlocktokenomicscliffschedulesupply

API URLhttps://x402.hexl.dev/v1/calc/cryptocalc-token-vesting-unlock

Integration docs

Example request

{
  "totalTokens": 1000000,
  "vestingMonths": 24,
  "cliffMonths": 6,
  "elapsedMonths": 12,
  "tokenPrice": 0.5
}

Example response

{
  "formula": "unlocked = total·min(1, elapsed/vesting) if elapsed >= cliff else 0",
  "totalTokens": 1000000,
  "cliffMonths": 6,
  "vestingMonths": 24,
  "elapsedMonths": 12,
  "pctUnlocked": 50,
  "unlockedTokens": 500000,
  "lockedTokens": 500000,
  "pastCliff": true,
  "fullyVested": false,
  "unlockedValueUsd": 250000,
  "lockedValueUsd": 250000
}

Input schema

{
  "type": "object",
  "required": [
    "totalTokens",
    "vestingMonths",
    "elapsedMonths"
  ],
  "properties": {
    "totalTokens": {
      "type": "number",
      "examples": [
        1000000
      ]
    },
    "vestingMonths": {
      "type": "number",
      "examples": [
        24
      ]
    },
    "cliffMonths": {
      "type": "number",
      "examples": [
        6
      ]
    },
    "elapsedMonths": {
      "type": "number",
      "examples": [
        12
      ]
    },
    "tokenPrice": {
      "type": "number",
      "description": "USD price for valuation",
      "examples": [
        0.5
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}