{"uid":"cap_sBI5M14FCUBqjRpRWMRRd","slug":"token-unlock-calendar-69ed7f2e","name":"Token Unlock Calendar","description":"Upcoming token-unlock calendar: the biggest unlocks across a basket of tokens within N days, ranked by USD value. Send { protocols?, days? }. See which supply shocks are coming and when.","url":"https://x402-services-production.up.railway.app/api/catalysts/calendar","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"number","description":"Look-ahead window in days, default 30 (max 180)"},"protocols":{"type":"object","description":"Optional array of protocol slugs; defaults to major tokens"}}},"responseSchema":null,"example":null,"exampleRequest":null,"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_FYPPst2f2YpJcbqIPI81X","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":"Returns the upcoming token unlock schedule ranked by USD value, showing supply shocks across a basket of protocols within a configurable look-ahead window.","exampleAgentPrompt":"Show me the biggest token unlocks happening in the next 60 days across major protocols, ranked by USD value, so I can see which supply shocks are coming.","exampleUseCases":[{"title":"Weekly supply shock risk scan","prompt":"Pull up all the token unlocks happening in the next 7 days and rank them by dollar value — I want to know which ones are big enough to cause selling pressure before I enter any new positions."},{"title":"Monthly DeFi emissions calendar","prompt":"Give me a full calendar of upcoming token unlocks across major DeFi protocols for the next 30 days, sorted by USD size, so I can plan around any large supply shocks hitting the market this month."},{"title":"Largest cliff unlocks next quarter","prompt":"Show me the biggest single-day token cliff unlocks scheduled over the next 90 days ranked by USD value — I'm trying to identify which protocols might face the most sudden sell pressure from vesting releases."}],"resultDescription":"A ranked list of upcoming token unlock events across a basket of protocols, each with the token/protocol name, unlock date, USD value of tokens being unlocked, and ordering by size of supply shock — all within the specified look-ahead window.","failureModes":["Invalid days value above 180 returns an error or clamped result","Unknown protocol slug in protocols array may be silently ignored or return an error","No unlocks found in the window returns an empty list","Stale data if the upstream unlock schedule hasn't been refreshed recently","Malformed request body (wrong type for days) returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need a consolidated, USD-ranked view of upcoming token unlocks across multiple protocols in a single call. Prefer this over per-token vesting lookups when you want a market-wide supply shock calendar without querying each protocol individually.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:24.507Z","isFirstParty":false}