{"uid":"cap_e_72er570OSFnDD7KCSbH","slug":"vaults-fyi-historical-tvl-time-series-0c30caa7","name":"vaults.fyi Historical TVL Time-Series","description":"Retrieves time-series historical TVL data for a specific vault, including base yield and rewards components over a customizable time range","url":"https://api.vaults.fyi/v2/historical/:network/:vaultId/tvl?utm_source=zero.xyz","method":"HEAD","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.102","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.102/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.102","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.102","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8bc11EGfKn3kQFOC3tnJJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.102","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves time-series historical TVL (Total Value Locked) data for a specific vault on a given blockchain network, with breakdowns by base yield and rewards components over a customizable time range","exampleAgentPrompt":"Pull the historical TVL time-series for the USDC vault (vault ID usdc-main) on Ethereum from vaults.fyi, including the base yield and rewards breakdown, covering the last 90 days.","exampleUseCases":[{"title":"DeFi vault due diligence research","prompt":"I'm evaluating a stablecoin vault on Arbitrum — can you pull its historical TVL data from vaults.fyi over the past 6 months so I can see if liquidity has been growing or shrinking?"},{"title":"Reward vs base yield TVL breakdown","prompt":"For the wstETH vault on Ethereum, show me the historical TVL split between base yield and rewards components over the last 30 days using vaults.fyi."},{"title":"Vault TVL trend monitoring for reporting","prompt":"I need a chart-ready time-series of TVL for vault ID 'aave-usdc-v3' on the Polygon network from vaults.fyi — give me daily data points for the past quarter."}],"resultDescription":"Returns a time-series array of TVL data points for the specified vault, each with a timestamp, total TVL value, and a breakdown into base yield and rewards components. Enables charting, trend analysis, and liquidity monitoring over the requested historical period.","failureModes":["Invalid or unsupported network identifier returns 404 or validation error","Unknown vault ID returns not found error","Requested time range exceeds available historical data","Rate limiting or payment failure (x402) blocks the request","Malformed date/time range parameters cause 400 bad request","Vault with no historical TVL data returns empty series"],"whenToPreferThis":"Use this endpoint when you need granular time-series TVL history for a specific vault, particularly when you want to distinguish between base yield and rewards contributions to TVL. Prefer this over the combined APY+TVL endpoint when TVL trending or liquidity analysis is the primary goal. Best suited for charting, dashboards, and due diligence workflows on individual vaults.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:23.347Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-historical-tvl-time-series-0c30caa7"}