{"uid":"cap_YhglSPyqga817N_x3bZoR","slug":"chain-tvl-history-b7236a00","name":"Chain TVL History","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/chain-tvl-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"integer","maximum":2000,"minimum":30,"description":"Look-back window in days (30-2000, default 365)"},"chain":{"type":"string","description":"Chain name, e.g. Ethereum, Base, Solana, Arbitrum"}}},"responseSchema":{"type":"json","example":{"note":"Chain TVL history. The distance from the peak shows where it is in the cycle. Source: DefiLlama.","chain":"Ethereum","series":[{"date":"2025-10-01","tvl_usd":87979353983},{"date":"2025-10-31","tvl_usd":84255331431}],"max_date":"2021-11-09","change_1y_pct":-40.24,"since_max_pct":-50.84,"change_30d_pct":8.32,"current_tvl_usd":52830721315,"historical_max_usd":107458598469}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ssgJgFONviF0SenMXpv9d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the TVL history of a blockchain including current value, all-time high, distance from ATH, 30d/1y changes, and a sampled time series, sourced from DefiLlama.","exampleAgentPrompt":"Pull the TVL history for Ethereum over the last 365 days — I want the current TVL, its all-time high and when that was, how far it is from the ATH, and the 30-day and 1-year percentage changes.","exampleUseCases":[{"title":"Cycle position check for Solana","prompt":"Where does Solana stand in the DeFi cycle right now? Give me its current TVL, all-time high, how far it's dropped from the peak, and how it's changed over the last 30 days and past year."},{"title":"Arbitrum TVL trend analysis","prompt":"Show me the TVL trend for Arbitrum over the last 180 days — I need the time series data, the ATH, and the 30-day and 1-year change percentages."},{"title":"Multi-chain recovery comparison","prompt":"How is Base recovering? Pull its TVL history for the last 365 days, including the all-time high date, current TVL, and how much it's down from its peak."}],"resultDescription":"A JSON object containing the chain name, current TVL in USD, historical maximum TVL in USD and its date, percentage distance from ATH, 30-day % change, 1-year % change, a note, and a sampled time series of date/TVL pairs covering the requested look-back window.","failureModes":["Unknown or misspelled chain name returns null or error","Look-back window outside 30–2000 day range returns validation error","DefiLlama data temporarily unavailable causes empty or null series","Chain with no DeFi activity returns zero or null TVL values","Very new chains may have insufficient history for the full requested window"],"whenToPreferThis":"Use this endpoint when you need historical TVL context for a specific blockchain — especially cycle position (distance from ATH), trend direction (30d/1y changes), and a time series for charting. Prefer this over a simple current-TVL lookup when the user wants to understand momentum, recovery, or where a chain stands relative to its peak. It is more focused than a full cross-chain rankings endpoint and more detailed than a snapshot metric.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:26:36.581Z","isFirstParty":false,"canonicalSlug":"chain-tvl-history-b7236a00"}