{"uid":"cap_egDKkYGWBGV8b2Ud5Hspz","slug":"delx-vesting-remaining-c72de133","name":"Delx Vesting Remaining","description":"Remaining unlock amount for linear vesting with optional cliff. Call when token unlock schedules for runway/treasury math. Returns vested, remaining, fraction_vested as deterministic JSON for $0.001 USDC via x402 on Base. First-party local math only—no RPC, live market feed, API keys, storage, or mediagen. Advisory only; the caller owns capital, risk, and production controls.","url":"https://api.delx.ai/api/v1/x402/vesting-remaining","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"total":{"type":"number","description":"Total token amount to vest"},"end_ts":{"type":"integer","description":"Vesting end unix timestamp"},"now_ts":{"type":"integer","description":"Evaluation unix timestamp"},"cliff_ts":{"type":"integer","description":"Optional cliff unix timestamp"},"start_ts":{"type":"integer","description":"Vesting start unix timestamp"}}},"responseSchema":{"type":"json","example":{"schema":"delx/util-vesting-remaining/v1","vested":400,"remaining":600,"fraction_vested":0.4}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MVxtRR5k9Kp5UDL6hneWs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates how many tokens remain unvested at a given point in time given a linear vesting schedule with optional cliff","exampleAgentPrompt":"A grant of 1000 tokens started vesting on Jan 1 2024 and ends on Jan 1 2026 with a 6-month cliff — how many tokens are still unvested as of today, July 1 2025?","exampleUseCases":[{"title":"Employee token grant vesting check","prompt":"We issued a 10000-token grant starting May 1 2023, ending May 1 2027, with a 1-year cliff. How many tokens have vested and how many are still locked as of January 1 2025?"},{"title":"DeFi protocol treasury vesting audit","prompt":"Our treasury vesting schedule has 5000000 tokens, started at unix timestamp 1672531200, ends at 1735689600, with a cliff at 1688169600. Evaluate how many tokens remain unvested right now at unix timestamp 1719792000."},{"title":"Investor allocation vesting progress","prompt":"An investor received 250000 tokens on a 4-year vesting schedule starting March 1 2022 with no cliff, ending March 1 2026. What fraction have they earned and what's still remaining as of March 1 2024?"}],"resultDescription":"Returns a JSON object containing: the number of tokens vested so far, the number of tokens still remaining (unvested), and the fraction vested as a decimal — all computed for the requested evaluation timestamp based on the linear vesting schedule and optional cliff.","failureModes":["Missing required fields (total, start_ts, end_ts, now_ts) returns an error","now_ts before start_ts may return zero vested tokens","now_ts after end_ts may return full vesting (zero remaining)","cliff_ts after now_ts returns zero vested tokens even if schedule has started","Non-numeric or malformed timestamps cause validation errors","Negative total token amounts may produce unexpected results"],"whenToPreferThis":"Use this endpoint when you need a fast, stateless computation of linear token vesting progress without building the math yourself — especially inside agent workflows that evaluate grant or treasury vesting at arbitrary points in time. Prefer this over custom code when you need consistent, auditable vesting math with cliff support in a single API call. Not suitable for non-linear or cliff-with-immediate-percentage vesting models.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:04:53.723Z","isFirstParty":false}