{"uid":"cap_2KiZAl2VMuSXCcTENQKXz","slug":"unlock-calendar-e182b8df","name":"unlock-calendar","description":"Forward-looking token unlock and vesting calendar for one crypto token. Give a ticker, name or slug and get the next unlock (date, token amount, USD value, percent of circulating supply), the full list of upcoming cliff and linear unlocks in a window, the allocation split across team, investors, ecosystem and community, supply metrics and a deterministic 0-100 supply-overhang score. Data from DeFiLlama, cited.","url":"https://payai.agentstools.dev/unlock/calendar?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Protocol name, e.g. Arbitrum"},"slug":{"type":"string","description":"DeFiLlama emissions slug, e.g. arbitrum"},"ticker":{"type":"string","description":"Token ticker symbol, e.g. ARB"},"window_days":{"type":"integer","maximum":1825,"minimum":1,"description":"Forward window for upcoming unlocks, default 365"},"include_backtest":{"type":"boolean","description":"Include price response to past unlocks (default false)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1mIrH3gRMFo4pftLoeWNx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token unlock and vesting calendar for a single crypto token, including next unlock details, upcoming cliff/linear unlocks, allocation breakdown, supply metrics, and a 0-100 supply-overhang score.","exampleAgentPrompt":"Pull up the token unlock calendar for ARB over the next 180 days — I want to see the next unlock date and amount, the full cliff and linear unlock schedule, how the allocation breaks down between team, investors, and ecosystem, and what the supply-overhang score is.","exampleUseCases":[{"title":"Pre-investment unlock risk check","prompt":"Before I buy into DYDX, can you show me all the upcoming token unlocks for the next year — especially how much is held by team and investors and what the supply-overhang score looks like?"},{"title":"Trader timing around cliff unlocks","prompt":"I want to know when the next big cliff unlock is for Aptos (APT), how many tokens will hit the market, what that's worth in USD, and what percentage of circulating supply it represents."},{"title":"Portfolio vesting monitoring for DeFi researcher","prompt":"Pull the full vesting and unlock calendar for Optimism (OP) for the next 90 days from DeFiLlama data, including the allocation split between team, investors, ecosystem, and community."}],"resultDescription":"Returns a structured object containing: the next unlock event (date, token amount, USD value, % of circulating supply), a list of upcoming cliff and linear unlocks within the requested window, allocation percentages across team/investors/ecosystem/community buckets, supply metrics (circulating, total, max supply), and a deterministic 0-100 supply-overhang score indicating potential sell pressure risk. Data is sourced from DeFiLlama.","failureModes":["Token not found — unrecognized ticker, name, or slug returns an error or empty result","Ambiguous ticker — multiple tokens share the same symbol, may require using the slug parameter instead","No upcoming unlocks in window — token may be fully vested or have no scheduled events in the requested period","DeFiLlama data unavailable — upstream data source may be stale or missing for obscure tokens","window_days out of range — values below 1 or above 1825 will fail schema validation"],"whenToPreferThis":"Use this endpoint when you need forward-looking tokenomics data for a specific crypto token — especially unlock schedules, vesting timelines, allocation breakdowns, and supply-pressure scoring. Prefer this over generic price or market-cap APIs when the question involves future supply changes, investor unlock risk, or vesting cliff events. The supply-overhang score makes it uniquely useful for pre-investment due diligence or trading timing decisions. Best when you know the ticker, name, or DeFiLlama slug of the token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:49:19.266Z","isFirstParty":false,"canonicalSlug":"unlock-calendar-e182b8df"}