{"uid":"cap_5X4OeQQb2ZaucVB9cZ2hd","slug":"defi-chain-tvl-history-d907ec7a","name":"DeFi Chain TVL History","description":"Daily total value locked history for one chain or for all of DeFi, up to ten years of points, with latest, first, minimum, maximum and mean and the change over the window. Use it when an agent is charting a chain's growth or checking whether a TVL move is new or a return to trend.","url":"https://agent402.tools/api/defi-chain-tvl-history","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"number","description":"Most recent days to return (default 90, max 3650)."},"chain":{"type":"string","description":"Chain name as DefiLlama spells it (Ethereum, Base, Solana, Arbitrum, Optimism, BSC...) or \"all\" for total DeFi TVL. Default \"all\"."}}},"responseSchema":{"type":"json","example":{"chain":"Base","count":2,"points":[{"date":"2026-08-21","tvlUsd":5242607753},{"date":"2026-08-22","tvlUsd":5432285625}],"source":"defillama-chain-tvl","summary":{"max":5432285625,"min":5242607753,"mean":5337446689,"first":5242607753,"latest":5432285625,"changePct":3.6},"fetchedAt":"2026-08-22T12:00:00.000Z","totalPoints":1165}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dFxPu3Go5pblwx6zw7iD0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical total value locked (TVL) time-series data for a specific blockchain or all DeFi chains combined, sourced from DefiLlama","exampleAgentPrompt":"Pull the last 30 days of TVL history for Base chain so I can see how total value locked has been trending — include the percentage change and summary stats.","exampleUseCases":[{"title":"DeFi ecosystem growth dashboard","prompt":"Get me the TVL history for Ethereum over the past 180 days — I want to see how liquidity has grown or shrunk and what the percentage change looks like."},{"title":"Cross-chain TVL comparison","prompt":"Fetch the last 90 days of TVL data for Arbitrum and also for all chains combined, so I can see how Arbitrum's share of DeFi is trending."},{"title":"Solana DeFi surge monitoring","prompt":"Show me the daily TVL data for Solana for the past 365 days — I need the min, max, mean, and latest values to understand if the recent buzz translated into real liquidity."}],"resultDescription":"Returns a JSON object containing the chain name, a time-ordered array of {date, tvlUsd} data points, summary statistics (min, max, mean, first, latest, changePct), the data source identifier ('defillama-chain-tvl'), a fetchedAt timestamp, the count of returned points, and the total points available. Data is sourced from DefiLlama.","failureModes":["Invalid chain name not recognized by DefiLlama returns an error or empty dataset","Requesting more than 3650 days exceeds the maximum range and may return an error","Network timeout if DefiLlama upstream is slow or unavailable","Chain with very recent launch may have fewer data points than requested days","Misspelled chain name (e.g. 'ethereum' vs 'Ethereum') may return no results if casing is strict"],"whenToPreferThis":"Use this endpoint when you need historical TVL time-series data for DeFi chains to perform trend analysis, build dashboards, monitor ecosystem growth, or compare chain-level liquidity over time. Prefer this over generic blockchain explorers when you specifically need TVL (not transaction counts or price data) aggregated across all protocols on a chain, with built-in summary statistics. It is ideal for agents that need DeFi macro-level data without managing DefiLlama API keys or authentication.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:49:21.693Z","isFirstParty":false}