{"uid":"cap_Kxr5-8dop8SsdFiULfZXW","slug":"defi-protocol-tvl-history-edfcf18e","name":"DeFi Protocol TVL History","description":"TVL history of a DeFi protocol (up to 5 years): series, 7/30/90/365-day change, all-time high and drawdown from it, and current TVL by chain. Live from DefiLlama.","url":"https://api.vextorium.com/v1/protocol-tvl-history?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["name"],"properties":{"days":{"type":"integer","description":"Days of series (7-1825, default 365)"},"name":{"type":"string","description":"Protocol, e.g. aave, lido, uniswap"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"date":{"type":["string","null"]},"slug":{"type":["string","null"]},"series":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"date":{"type":["null","string"]},"tvl_usd":{"type":["null","number"]}}}},"source":{"type":["string","null"]},"tvl_usd":{"type":["number","null"]},"by_chain":{"type":["object","null"],"properties":{"Base":{"type":["number","null"]},"xDai":{"type":["number","null"]},"Linea":{"type":["number","null"]},"Monad":{"type":["number","null"]},"Sonic":{"type":["number","null"]},"Mantle":{"type":["number","null"]},"Plasma":{"type":["number","null"]},"Binance":{"type":["number","null"]},"MegaETH":{"type":["number","null"]},"Polygon":{"type":["number","null"]},"X Layer":{"type":["number","null"]},"Arbitrum":{"type":["number","null"]},"Ethereum":{"type":["number","null"]},"Optimism":{"type":["number","null"]},"Avalanche":{"type":["number","null"]}}},"protocol":{"type":["string","null"]},"change_pct":{"type":["object","null"],"properties":{"7d":{"type":["number","null"]},"30d":{"type":["number","null"]},"90d":{"type":["number","null"]},"365d":{"type":["number","null"]}}},"historical_max":{"type":["object","null"],"properties":{"date":{"type":["string","null"]},"tvl_usd":{"type":["number","null"]},"drop_since_max_pct":{"type":["number","null"]}}}}}}}}},"responseSchema":{"type":"json","example":{"date":"2026-10-02","slug":"aave-v3","series":[{"date":"2026-07-05","tvl_usd":12859246586},{"date":"2026-07-06","tvl_usd":12889768625}],"source":"DefiLlama","tvl_usd":18513893247,"by_chain":{"Base":572676307,"xDai":60119328,"Linea":9580388,"Monad":321958922,"Sonic":6093686,"Mantle":57317958,"Plasma":438261046,"Binance":215561732,"MegaETH":12238169,"Polygon":149483827,"X Layer":117094427,"Arbitrum":537483919,"Ethereum":15600173708,"Optimism":55519034,"Avalanche":353527979},"protocol":"Aave V3","change_pct":{"7d":1.23,"30d":8.59,"90d":45.35,"365d":-58.12},"historical_max":{"date":"2025-10-07","tvl_usd":45443859638,"drop_since_max_pct":-59.26}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kyhISlcOdZHVlOk2HaoMY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns up to 5 years of TVL history for a named DeFi protocol, including time-series data, 7/30/90/365-day change percentages, all-time high, drawdown from ATH, and current TVL broken down by chain.","exampleAgentPrompt":"What does Aave's TVL look like over the last 90 days? I want the time series, how much it's changed over 7, 30, 90, and 365 days, the all-time high, how far it's dropped from that peak, and a breakdown by chain.","exampleUseCases":[{"title":"DeFi protocol health check","prompt":"Give me a full TVL report on Lido for the past year — the daily series, how it's changed over 7, 30, 90, and 365 days, what the all-time high was and how far it's fallen from that, and how TVL is split across chains right now."},{"title":"Comparing protocol peak and recovery","prompt":"What's Uniswap's all-time high TVL and how much has it dropped from that peak? Also show me the 365-day change percentage and the current chain-by-chain breakdown."},{"title":"Short-term TVL momentum check","prompt":"Pull 30 days of TVL history for Curve Finance and tell me the 7-day and 30-day percentage changes — I want to see whether it's been gaining or losing value locked recently."}],"resultDescription":"Returns a JSON object containing: the protocol's canonical slug and display name, current total TVL in USD, a daily time-series array of TVL values (up to 1825 days), percentage changes over 7, 30, 90, and 365 days, the all-time high TVL with its date and the percentage drawdown from that peak, and current TVL broken down by individual blockchain (Ethereum, Arbitrum, Base, Polygon, Optimism, Avalanche, Binance, etc.). Data is sourced live from DefiLlama.","failureModes":["Unknown protocol name returns an error or empty result — use DefiLlama slug format (e.g. 'aave-v3' not 'AAVE')","Days parameter outside 7–1825 range may be rejected or clamped","Protocol with very short history may return fewer data points than requested","DefiLlama upstream outage causes stale or missing data","Some chains may return null TVL if the protocol is not deployed there"],"whenToPreferThis":"Use this endpoint when you need historical TVL data for a specific DeFi protocol, including trend analysis, ATH/drawdown context, and multi-chain breakdown. It is ideal for protocol due diligence, DeFi market research, and portfolio monitoring. Prefer this over general blockchain comparison endpoints when the focus is a single protocol's performance over time rather than chain-level aggregates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:55:30.773Z","isFirstParty":false,"canonicalSlug":"defi-protocol-tvl-history-edfcf18e"}