{"uid":"cap_CmXbaIlTs55zEhOC1_Lsn","slug":"blockrun-ai-b08ac52f","name":"BlockRun.AI Token Unlock Schedule & Vesting","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/token/tokenomics","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"input":{"body":{"symbol":"BTC"}}},"response":{"data":[{"timestamp":1778716800,"allocations":[{"name":"Mining rewards","amount":20028955}],"unlock_amount":20028955.419970997},{"timestamp":1778803200,"allocations":[{"name":"Mining rewards","amount":20029427}],"unlock_amount":20029427.294970997},{"timestamp":1778889600,"allocations":[{"name":"Mining rewards","amount":20029880}],"unlock_amount":20029880.419970997},{"timestamp":1778976000,"allocations":[{"name":"Mining rewards","amount":20030352}],"unlock_amount":20030352.294970997},{"timestamp":1779062400,"allocations":[{"name":"Mining rewards","amount":20030789}],"unlock_amount":20030789.794970997},{"timestamp":1779148800,"allocations":[{"name":"Mining rewards","amount":20031227}],"unlock_amount":20031227.294970997},{"timestamp":1779235200,"allocations":[{"name":"Mining rewards","amount":20031671}],"unlock_amount":20031671.044970997},{"timestamp":1779321600,"allocations":[{"name":"Mining rewards","amount":20032146}],"unlock_amount":20032146.044970997},{"timestamp":1779408000,"allocations":[{"name":"Mining rewards","amount":20032542}],"unlock_amount":20032542.919970997},{"timestamp":1779494400,"allocations":[{"name":"Mining rewards","amount":20033030}],"unlock_amount":20033030.419970997},{"timestamp":1779580800,"allocations":[{"name":"Mining rewards","amount":20033542}],"unlock_amount":20033542.919970997},{"timestamp":1779667200,"allocations":[{"name":"Mining rewards","amount":20033952}],"unlock_amount":20033952.294970997},{"timestamp":1779753600,"allocations":[{"name":"Mining rewards","amount":20034467}],"unlock_amount":20034467.919970997},{"timestamp":1779840000,"allocations":[{"name":"Mining rewards","amount":20034902}],"unlock_amount":20034902.294970997},{"timestamp":1779926400,"allocations":[{"name":"Mining rewards","amount":20035363}],"unlock_amount":20035363.902113855},{"timestamp":1780012800,"allocations":[{"name":"Mining rewards","amount":20035825}],"unlock_amount":20035825.509256713},{"timestamp":1780099200,"allocations":[{"name":"Mining rewards","amount":20036287}],"unlock_amount":20036287.11639957},{"timestamp":1780185600,"allocations":[{"name":"Mining rewards","amount":20036748}],"unlock_amount":20036748.72354243},{"timestamp":1780272000,"allocations":[{"name":"Mining rewards","amount":20037210}],"unlock_amount":20037210.330685288},{"timestamp":1780358400,"allocations":[{"name":"Mining rewards","amount":20037671}],"unlock_amount":20037671.937828146},{"timestamp":1780444800,"allocations":[{"name":"Mining rewards","amount":20038133}],"unlock_amount":20038133.544971004},{"timestamp":1780531200,"allocations":[{"name":"Mining rewards","amount":20038595}],"unlock_amount":20038595.152113862},{"timestamp":1780617600,"allocations":[{"name":"Mining rewards","amount":20039056}],"unlock_amount":20039056.75925672},{"timestamp":1780704000,"allocations":[{"name":"Mining rewards","amount":20039518}],"unlock_amount":20039518.36639958},{"timestamp":1780790400,"allocations":[{"name":"Mining rewards","amount":20039979}],"unlock_amount":20039979.973542437},{"timestamp":1780876800,"allocations":[{"name":"Mining rewards","amount":20040441}],"unlock_amount":20040441.580685295},{"timestamp":1780963200,"allocations":[{"name":"Mining rewards","amount":20040903}],"unlock_amount":20040903.187828153},{"timestamp":1781049600,"allocations":[{"name":"Mining rewards","amount":20041364}],"unlock_amount":20041364.79497101},{"timestamp":1781136000,"allocations":[{"name":"Mining rewards","amount":20041826}],"unlock_amount":20041826.40211387},{"timestamp":1781222400,"allocations":[{"name":"Mining rewards","amount":20042288}],"unlock_amount":20042288.009256728},{"timestamp":1781308800,"allocations":[{"name":"Mining rewards","amount":20042749}],"unlock_amount":20042749.616399586}],"meta":{"limit":31,"total":31,"cached":false,"offset":0,"credits_used":1},"$schema":"https://api.asksurf.ai/schemas/DataResponseTokenUnlockPoint.json"}},"exampleRequest":{"input":{"body":{"symbol":"BTC"}}},"tags":["x402"],"displayCostAmount":"0.0075","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u6dEkTiNaoBFofV31SgiQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token unlock schedule and vesting details for a cryptocurrency token, including release timelines and tokenomics data.","exampleAgentPrompt":"Can you pull up the token unlock schedule and vesting details for the ARB token so I can see when major unlocks are happening and how much supply is being released?","exampleUseCases":null,"resultDescription":"Returns structured tokenomics data including token unlock schedules, vesting tranches, cliff dates, linear release timelines, percentages of total supply unlocked over time, and upcoming release events for the queried token.","failureModes":["Token not found or unsupported — returns empty or error response","Invalid token symbol/address — returns 400 or null data object","Network timeout — no response or partial data","Token has no tracked vesting schedule — returns empty data","Rate limit exceeded — 429 response"],"whenToPreferThis":"Use this endpoint when you need structured token vesting and unlock schedule data for a specific cryptocurrency, especially when researching upcoming supply unlocks that may affect token price or market dynamics. Prefer this over general market data endpoints when the specific question is about future token release schedules rather than current price or volume.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:49:53.871Z","isFirstParty":false}