{"uid":"cap_dA91SgDPRNlohWF6LuppE","slug":"halowerk-kettenwerk-token-unlock-schedule-lookup-974ed562","name":"HALOWERK kettenwerk Token Unlock Schedule Lookup","description":"Looks up a crypto asset by its exact NetSupply slug or an unambiguous symbol, then returns the scheduled releases inside a caller-selected window of up to 365 days. Unlock amounts remain decimal strings so large token quantities are not rounded. Each event states whether the schedule is enforced on-chain, how many lock objects it combines, when the promise was first recorded and how often it was revised. The percentage of float uses current circulating supply from CoinGecko, or a caller-supplied","url":"https://kette.halowerk.com/token/unlocks","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","default":90,"maximum":365,"minimum":1,"description":"Calendar window from today in UTC, inclusive. Default 90 days."},"asset":{"type":"string","maxLength":80,"minLength":1,"description":"Exact NetSupply slug such as \"xrp\" or an unambiguous token symbol such as \"XRP\"."},"circulating_supply":{"type":"number","description":"Optional current circulating supply. When omitted, CoinGecko is used. The response always identifies which basis was used.","exclusiveMinimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iR6b3XmDOHt5gwYO1V3Dg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns scheduled token unlock/release events for a crypto asset within a caller-specified window of up to 365 days, including on-chain enforcement status and float percentage.","exampleAgentPrompt":"Pull the token unlock schedule for ARB from kettenwerk over the next 180 days and tell me how much of the circulating float is being released and whether those unlocks are enforced on-chain.","exampleUseCases":[{"title":"Pre-trade unlock risk check","prompt":"Before I buy a large position in OP, check what token unlocks are scheduled in the next 60 days and what percentage of the circulating supply that represents — I want to know if there's a big dump risk coming."},{"title":"Yearly vesting calendar for portfolio","prompt":"Pull the full 365-day unlock schedule for SUI and tell me the dates, amounts as decimal strings, and whether each release event is enforced on-chain or just a promise."},{"title":"Investor due diligence on unlock revisions","prompt":"I'm researching a token called PYTH — can you look up its unlock schedule for the next 90 days and tell me how many times the schedule has been revised since it was first recorded?"}],"resultDescription":"A list of scheduled token unlock/release events within the requested window, each containing the unlock date, token amount as a decimal string, whether the schedule is enforced on-chain, the number of lock objects combined, the date the schedule was first recorded, the number of revisions, and the percentage of circulating float being unlocked (sourced from CoinGecko or caller-supplied supply).","failureModes":["Ambiguous token symbol returns an error asking for a more specific slug","Unknown asset slug or symbol returns a not-found error","Requested window exceeds 365 days returns a validation error","CoinGecko unavailable when no circulating_supply provided may delay or fail the float percentage calculation","No unlock data indexed for a given asset returns an empty events list"],"whenToPreferThis":"Use this endpoint when you need precise, decimal-accurate token unlock schedules with on-chain enforcement metadata for a specific crypto asset over a defined calendar window. It is preferable to generic market data APIs when you need vesting schedule revision history, lock object counts, and on-chain vs off-chain enforcement status — details that CoinGecko or CoinMarketCap do not surface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:21.533Z","isFirstParty":false}