{"uid":"cap_bCCPYmP84JwDq69jkVgzW","slug":"messari-token-unlock-events-86f250d9","name":"Messari Token Unlock Events","description":"Get upcoming token unlock events for a specific crypto asset.","url":"https://api.messari.io/token-unlocks/v1/assets/*/events","method":"GET","headers":{},"bodySchema":{"type":"object","required":["assetId"],"properties":{"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1},"assetId":{"type":"string","description":"Asset identifier in the route path."},"endDate":{"type":"string"},"startDate":{"type":"string"}}},"responseSchema":{"example":{"data":[{"amount":1500000,"assetId":"bitcoin","category":"investors","amountUsd":90000000,"unlockDate":"2026-05-01","percentCirculatingSupply":0.7}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qt961eLF7WGJ3OYQ8SMQe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming token unlock events for a specific crypto asset, including dates, amounts, categories, and percent of circulating supply.","exampleAgentPrompt":"Pull all upcoming token unlock events for Arbitrum from Messari — start from January 1 2026 through December 31 2026, show up to 50 results, and include the USD value and percent of circulating supply for each unlock.","exampleUseCases":null,"resultDescription":"A paginated list of token unlock events for the specified asset, each containing the unlock date, token amount, USD value at time of unlock, the category of recipient (e.g. investors, team), and the percent of circulating supply being unlocked.","failureModes":["Unknown or unsupported assetId returns a 404 or empty data array","Invalid date format for startDate or endDate causes a 400 bad request","Asset has no tracked unlock schedule — returns empty data array","Page number out of range returns empty results","Missing required assetId parameter returns a 400 error","Payment not completed results in 402 Payment Required before data is returned"],"whenToPreferThis":"Use this endpoint when you need event-level granularity of token unlocks for a specific asset, especially when filtering by date range or paginating through many events. Prefer this over the full vesting schedule endpoint when you want discrete upcoming unlock events rather than the complete vesting curve.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:19.396Z","isFirstParty":false}