{"uid":"cap_cfi_UKyubaxWLRHR_YeBO","slug":"messari-token-vesting-schedule-bf054dae","name":"Messari Token Vesting Schedule","description":"Get full token vesting schedule details for a specific crypto asset.","url":"https://api.messari.io/token-unlocks/v1/assets/*/vesting-schedule","method":"GET","headers":{},"bodySchema":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","description":"Asset identifier in the route path."}}},"responseSchema":{"example":{"data":{"assetId":"bitcoin","schedule":[{"date":"2026-05-01","amount":500000,"category":"team","percentOfSupply":0.25}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.75","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.75/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M07qFfX_y4of_ZRyx2XJC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full token vesting schedule for a specific crypto asset, including unlock dates, amounts, categories, and percent of supply.","exampleAgentPrompt":"Pull the full token vesting schedule for Arbitrum from Messari — I want to see every tranche, the unlock dates, amounts, which category each belongs to like team or investor, and what percentage of supply each represents.","exampleUseCases":null,"resultDescription":"A structured vesting schedule object for the requested crypto asset, containing an array of vesting events each with a date, token amount to be unlocked, category (e.g. team, investor, community), and the percentage of total supply that unlock represents.","failureModes":["Asset not found or not tracked — returns 404 or empty data if the assetId is invalid or Messari does not track vesting for that asset","No vesting schedule available — some assets may not have structured token unlock data, returning an empty schedule array","Authentication/payment failure — x402 payment not processed, returns 402 Payment Required","Rate limiting — too many requests in a short window, returns 429","Malformed assetId — passing an unrecognized slug returns an error"],"whenToPreferThis":"Use this endpoint when you need the complete, multi-tranche vesting schedule for a crypto asset — all past and future unlock events across all categories. Prefer this over the 'upcoming unlocks' endpoint when you need historical context, full supply distribution breakdown by category (team, investors, ecosystem), or a comprehensive tokenomics analysis rather than just next scheduled events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:39.949Z","isFirstParty":false}