{"uid":"cap_sMUdf8jkKUVb_qhDyQJ4D","slug":"chainray-token-unlock-schedule-0f810dad","name":"ChainRay Token Unlock Schedule","description":"The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.","url":"https://chainray.online/token-unlock/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"Blockchain network"},"address":{"type":"string","description":"Wallet or contract address"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","address":"0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984"}}},"response":{"note":"Contract does not match known vesting/timelock patterns (LinearVesting, CliffVesting, TeamTokenTimelock).","type":"UNKNOWN","chain":"ethereum","_proof":{"chain":"ethereum","dataHash":"17bc8d008a6addcfc6f16eabed169931c46d53b03233367107d042fea5af0522","blockHash":"0x16b66dece077a7930064853a2d51606d832c2e634a82aa8f732dbce2d61e0a64","chainName":"Ethereum","blockNumber":25342601,"proofVersion":"3.0","blockTimestamp":1781763443,"proofTimestamp":1781763451962},"contract":"0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984","timestamp":1781763451962}},"exampleRequest":{"chain":"ethereum","address":"0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984"},"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3AlnoY2TxPDPQiwRqkI8n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns token unlock schedule and vesting data for a given token contract address on a specified blockchain","exampleAgentPrompt":"Look up the token unlock schedule for contract address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — I want to see all upcoming vesting events and how many tokens get released on each date.","exampleUseCases":[{"title":"Monitor competitor token unlock timing","prompt":"Check the vesting schedule for Uniswap's UNI token on Ethereum — I need to know when their team and investor allocations unlock so I can track potential market pressure points."},{"title":"Track DeFi protocol governance tokens","prompt":"Pull up the token unlock schedule for Aave's AAVE contract on Ethereum and Polygon — show me the upcoming cliff dates and how much gets released each month so I can plan governance participation."},{"title":"Identify presale token lock-ups","prompt":"Look up the vesting data for this new protocol's token at 0x... on Arbitrum — I want to see if early investors are still locked up or if they'll start dumping tokens soon."}],"resultDescription":"Returns a structured token unlock schedule including vesting event dates, amounts to be unlocked per event, cliff periods, and cumulative unlock percentages for the specified token contract address on the given blockchain network.","failureModes":["Invalid contract address returns 400 or empty result","Address is not a token with vesting schedule — no unlock data found","Unsupported chain specified — 404 or error response","Payment failure via x402 — 402 response requiring USDC payment","Rate limiting or upstream data unavailability — 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need on-chain token unlock and vesting schedule data for a specific contract address, especially for DeFi research, tokenomics analysis, or monitoring upcoming token release events. Prefer this over generic blockchain explorers when you need structured, agent-consumable vesting data across 46 chains with pay-per-request pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:47:31.694Z","isFirstParty":false}