{"uid":"cap_XvTxBiXHi0YqGv1xjEWEV","slug":"messari-token-unlocks-allocation-breakdowns-b5e76fad","name":"Messari Token Unlocks — Allocation Breakdowns","description":"Get token allocation breakdowns by category and vesting bucket.","url":"https://api.messari.io/token-unlocks/v1/allocations","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1},"assetId":{"type":"string"}}},"responseSchema":{"example":{"data":[{"assetId":"bitcoin","assetName":"Bitcoin","allocations":[{"amount":2500000,"category":"team","vestingEnd":"2028-01-01","vestingStart":"2024-01-01","percentOfSupply":2.5}]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CZ8cMYgOHCXAyHOY-JKYP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns token allocation breakdowns by category (e.g. team, investors) and vesting bucket for a given crypto asset.","exampleAgentPrompt":"Pull the Messari token allocation breakdown for Solana — show me how the supply is split across categories like team and investors, including vesting start and end dates. Give me the first page with up to 10 results.","exampleUseCases":null,"resultDescription":"A paginated list of allocation records for the specified crypto asset, each containing the category (e.g. 'team', 'investors'), total amount allocated, percentage of total supply, and vesting start/end dates.","failureModes":["Unknown or invalid assetId returns empty data array or 404","Exceeding rate limits or unpaid x402 payment results in 402 Payment Required","Invalid pagination parameters (page < 1 or limit < 1) may return 400 Bad Request","Asset with no unlock data returns empty allocations array"],"whenToPreferThis":"Use this endpoint when you need structured, institutional-grade token vesting and allocation data broken down by stakeholder category for a specific crypto asset. Prefer this over generic crypto APIs when you need vesting bucket granularity (start/end dates per category) rather than just circulating supply figures.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:56:16.064Z","isFirstParty":false}