Equity vesting schedule calculator API

Compute vested vs unvested shares under a standard cliff + monthly schedule (default 4yr / 1yr cliff): nothing vests before the cliff, then shares/month = total/(years x 12) accrue, returning percent vested and cliff status. Deterministic vesting math. Answers 'how many shares are vested at month 24','did I pass my cliff','what's my unvested equity'.

Price$0.01per request

MethodPOST

Route/v1/calc/hr-equity-vesting

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

hrequityvestingstockrsucalccliffshares

API URLhttps://x402.hexl.dev/v1/calc/hr-equity-vesting

Integration docs

Example request

{
  "totalShares": 48000,
  "monthsElapsed": 24
}

Example response

{
  "totalShares": 48000,
  "vestingYears": 4,
  "cliffMonths": 12,
  "monthsElapsed": 24,
  "totalMonths": 48,
  "sharesPerMonth": 1000,
  "cliffReached": true,
  "vestedShares": 24000,
  "unvestedShares": 24000,
  "percentVested": 50,
  "fullyVested": false
}

Input schema

{
  "type": "object",
  "required": [
    "totalShares",
    "monthsElapsed"
  ],
  "properties": {
    "totalShares": {
      "type": "number",
      "description": "Total shares in the grant",
      "examples": [
        48000
      ]
    },
    "vestingYears": {
      "type": "number",
      "default": 4,
      "examples": [
        4
      ]
    },
    "cliffMonths": {
      "type": "number",
      "default": 12,
      "examples": [
        12
      ]
    },
    "monthsElapsed": {
      "type": "number",
      "description": "Months since the vesting start date",
      "examples": [
        24
      ]
    }
  }
}

Output schema

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