{"uid":"cap_uvN_3md01c809WTwfu7ZK","slug":"api-quantoracle-dev-e69b2106","name":"QuantOracle Crypto Vesting Schedule Calculator","description":"QuantOracle: crypto/vesting-schedule","url":"https://api.quantoracle.dev/v1/crypto/vesting-schedule","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":null,"example":{"request":{"cliff_months":12,"total_tokens":1000000,"tge_percentage":10,"vesting_months":36},"response":{"ms":8.53,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"schedule":[{"month":1,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":2,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":3,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":4,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":5,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":6,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":7,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":8,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":9,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":10,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":11,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":12,"cumulative":0,"pct_unlocked":0,"tokens_unlocked":0},{"month":13,"cumulative":27777.78,"pct_unlocked":2.7778,"tokens_unlocked":27777.78},{"month":14,"cumulative":55555.56,"pct_unlocked":5.5556,"tokens_unlocked":27777.78},{"month":15,"cumulative":83333.33,"pct_unlocked":8.3333,"tokens_unlocked":27777.78},{"month":16,"cumulative":111111.11,"pct_unlocked":11.1111,"tokens_unlocked":27777.78},{"month":17,"cumulative":138888.89,"pct_unlocked":13.8889,"tokens_unlocked":27777.78},{"month":18,"cumulative":166666.67,"pct_unlocked":16.6667,"tokens_unlocked":27777.78},{"month":19,"cumulative":194444.44,"pct_unlocked":19.4444,"tokens_unlocked":27777.78},{"month":20,"cumulative":222222.22,"pct_unlocked":22.2222,"tokens_unlocked":27777.78},{"month":21,"cumulative":250000,"pct_unlocked":25,"tokens_unlocked":27777.78},{"month":22,"cumulative":277777.78,"pct_unlocked":27.7778,"tokens_unlocked":27777.78},{"month":23,"cumulative":305555.56,"pct_unlocked":30.5556,"tokens_unlocked":27777.78},{"month":24,"cumulative":333333.33,"pct_unlocked":33.3333,"tokens_unlocked":27777.78},{"month":25,"cumulative":361111.11,"pct_unlocked":36.1111,"tokens_unlocked":27777.78},{"month":26,"cumulative":388888.89,"pct_unlocked":38.8889,"tokens_unlocked":27777.78},{"month":27,"cumulative":416666.67,"pct_unlocked":41.6667,"tokens_unlocked":27777.78},{"month":28,"cumulative":444444.44,"pct_unlocked":44.4444,"tokens_unlocked":27777.78},{"month":29,"cumulative":472222.22,"pct_unlocked":47.2222,"tokens_unlocked":27777.78},{"month":30,"cumulative":500000,"pct_unlocked":50,"tokens_unlocked":27777.78},{"month":31,"cumulative":527777.78,"pct_unlocked":52.7778,"tokens_unlocked":27777.78},{"month":32,"cumulative":555555.56,"pct_unlocked":55.5556,"tokens_unlocked":27777.78},{"month":33,"cumulative":583333.33,"pct_unlocked":58.3333,"tokens_unlocked":27777.78},{"month":34,"cumulative":611111.11,"pct_unlocked":61.1111,"tokens_unlocked":27777.78},{"month":35,"cumulative":638888.89,"pct_unlocked":63.8889,"tokens_unlocked":27777.78},{"month":36,"cumulative":666666.67,"pct_unlocked":66.6667,"tokens_unlocked":27777.78},{"month":37,"cumulative":694444.44,"pct_unlocked":69.4444,"tokens_unlocked":27777.78},{"month":38,"cumulative":722222.22,"pct_unlocked":72.2222,"tokens_unlocked":27777.78},{"month":39,"cumulative":750000,"pct_unlocked":75,"tokens_unlocked":27777.78},{"month":40,"cumulative":777777.78,"pct_unlocked":77.7778,"tokens_unlocked":27777.78},{"month":41,"cumulative":805555.56,"pct_unlocked":80.5556,"tokens_unlocked":27777.78},{"month":42,"cumulative":833333.33,"pct_unlocked":83.3333,"tokens_unlocked":27777.78},{"month":43,"cumulative":861111.11,"pct_unlocked":86.1111,"tokens_unlocked":27777.78},{"month":44,"cumulative":888888.89,"pct_unlocked":88.8889,"tokens_unlocked":27777.78},{"month":45,"cumulative":916666.67,"pct_unlocked":91.6667,"tokens_unlocked":27777.78},{"month":46,"cumulative":944444.44,"pct_unlocked":94.4444,"tokens_unlocked":27777.78},{"month":47,"cumulative":972222.22,"pct_unlocked":97.2222,"tokens_unlocked":27777.78},{"month":48,"cumulative":1000000,"pct_unlocked":100,"tokens_unlocked":27777.78}],"tge_tokens":0,"total_tokens":1000000,"vesting_type":"linear","fully_vested_month":48}},"exampleRequest":{"cliff_months":12,"total_tokens":1000000,"tge_percentage":10,"vesting_months":36},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_elPNret3rsA_NqrCbTRn7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes a month-by-month token vesting schedule given TGE percentage, cliff, linear/custom vesting parameters, and total supply","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:38.327Z","isFirstParty":false}