{"uid":"cap_DhFZOcSMSw-sFl_T8IoCx","slug":"unlock-upcoming-e2ccfb00","name":"unlock-upcoming","description":"Market-wide screener of the biggest upcoming token unlocks across many crypto tokens in a forward window. Returns the largest scheduled unlocks ranked by USD value or by percent of circulating supply, each with its date, token amount and protocol. Bounded fan-out across the most active emitters. Data from DeFiLlama, cited.","url":"https://payai.agentstools.dev/unlock/upcoming","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":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Max rows to return, default 25"},"rank_by":{"enum":["usd_value","pct_float"],"type":"string","description":"Rank by unlock USD value or percent of circulating"},"window_days":{"type":"integer","maximum":1825,"minimum":1,"description":"Forward window in days, default 90"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MsXIubXUxB4GhWYBco0tf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a market-wide screener of the largest upcoming token unlocks across crypto protocols, ranked by USD value or percent of circulating supply, within a configurable forward time window.","exampleAgentPrompt":"Show me the top 15 upcoming token unlocks over the next 60 days, ranked by USD value — I want to see which protocols have the biggest scheduled releases coming up.","exampleUseCases":[{"title":"Pre-trade unlock risk check","prompt":"Before I take a large long position in any altcoin, can you pull the top 25 upcoming token unlocks by USD value in the next 30 days so I can avoid tokens with massive vesting events about to hit?"},{"title":"Percent float unlock screening","prompt":"Which tokens have the biggest upcoming unlocks relative to their circulating supply over the next 90 days? Rank by percent of float and show me up to 20 results."},{"title":"Quarterly unlock calendar for DeFi research","prompt":"I'm writing a DeFi market outlook — can you get me the top 25 scheduled token unlocks by USD value over the next 180 days so I can highlight the most significant vesting events coming up?"}],"resultDescription":"A ranked list of upcoming token unlock events, each including the token name, protocol, scheduled unlock date, token amount to be released, estimated USD value of the unlock, and the unlock size as a percent of circulating supply. Results are bounded to the requested limit and sorted by the chosen ranking method (USD value or percent of float).","failureModes":["Invalid rank_by value (must be 'usd_value' or 'pct_float') returns a validation error","window_days outside 1–1825 range returns a schema validation error","limit outside 1–25 range is rejected","Upstream DeFiLlama data unavailability may result in stale or empty results","Payment failure (x402 protocol) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a forward-looking, market-wide view of scheduled token unlock events ranked by economic impact (USD value or circulating supply percentage). It is ideal for pre-trade risk checks, DeFi research, and identifying potential sell-pressure catalysts. It covers many tokens simultaneously rather than requiring per-token queries, and data is sourced from DeFiLlama for credibility. Prefer it over manual on-chain analysis or single-token vesting trackers when you need a broad screener sorted by magnitude.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:59:09.061Z","isFirstParty":false}