{"uid":"cap_507OZJ4B2YHq7bHvzgqlv","slug":"messari-token-unlock-history-c0024798","name":"Messari Token Unlock History","description":"Get historical token unlock records for a specific crypto asset.","url":"https://api.messari.io/token-unlocks/v1/assets/*/unlocks","method":"GET","headers":{},"bodySchema":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","description":"Asset identifier in the route path."},"endDate":{"type":"string"},"startDate":{"type":"string"}}},"responseSchema":{"example":{"data":[{"date":"2025-03-01","amount":1200000,"assetId":"bitcoin","amountUsd":72000000,"cumulativeUnlocked":5800000}]}},"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_G9YbM1mM7F0JGlLSv9n1i","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":"Retrieves historical token unlock records for a specific crypto asset, including dates, amounts, USD values, and cumulative unlocked totals.","exampleAgentPrompt":"Pull the Messari token unlock history for Arbitrum (ARB) from January 1, 2025 to March 31, 2025 so I can see how many tokens were released each month and the cumulative unlocked supply.","exampleUseCases":null,"resultDescription":"Returns an array of historical unlock records for the specified asset, each containing the date of the unlock, the amount of tokens unlocked, the USD equivalent at that time, and the cumulative total of tokens unlocked to date.","failureModes":["Invalid or unrecognized asset ID returns a 404 or empty data array","Date range outside available data coverage returns empty results","Malformed date format (not ISO 8601) may return a 400 bad request","Missing required assetId path parameter returns a 400 or 422 error","Payment not processed (x402) results in a 402 Payment Required response","Rate limiting or quota exceeded returns a 429 response"],"whenToPreferThis":"Use this endpoint when you need time-series data on past token unlock events for a specific crypto asset, including USD valuations and cumulative supply release totals. Ideal for analyzing vesting schedules, supply inflation pressure, or comparing unlock cadences across date ranges. Prefer this over real-time or scheduled unlock endpoints when historical context or trend analysis is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:24.145Z","isFirstParty":false}