{"uid":"cap_nQzH08GyDBtP_zJy59otb","slug":"vaults-fyi-historical-apy-tvl-6cc1639b","name":"vaults.fyi Historical APY & TVL","description":"Retrieves historical APY and TVL for a specific vault, based on the provided query parameters.","url":"https://api.vaults.fyi/v2/historical/:network/:vaultId?utm_source=zero.xyz","method":"HEAD","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.306","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.306/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.306","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.306","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dcFbpy26k5q60LYS7xpSH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.306","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical APY and TVL time-series data for a specific DeFi vault on a given blockchain network.","exampleAgentPrompt":"Can you pull up the historical APY and TVL data for vault 0xabc123 on the Ethereum network so I can see how its yield has trended over time?","exampleUseCases":[{"title":"Yield trend analysis for investment decision","prompt":"Show me the historical APY and TVL for vault 0xUSDC-Aave on Ethereum — I want to see how the yield has trended over the past few months before I decide to deposit."},{"title":"Vault performance monitoring for a dashboard","prompt":"Fetch the historical APY and TVL data for vault 0xDAI-Compound on Polygon so I can update my DeFi portfolio performance dashboard."},{"title":"Comparing vault stability over time","prompt":"Get me the historical APY and TVL for vault 0xWETH-Lido on Arbitrum — I need to see if its yield has been consistent or volatile over the last quarter."}],"resultDescription":"Returns a time-series dataset containing historical APY (annual percentage yield) and TVL (total value locked) values for the specified vault on the given network, indexed over time and queryable via parameters.","failureModes":["Invalid or unsupported network identifier returns 404 or error","Unknown vaultId returns empty or not-found response","Missing required path parameters returns 400 bad request","Rate limiting or quota exceeded returns 429","No historical data available for very new vaults"],"whenToPreferThis":"Use this endpoint when you need historical APY and TVL data for a specific vault — ideal for trend analysis, performance monitoring, or investment research. Prefer this over the TVL-only or APY-only breakdown endpoints when you need both metrics in a combined historical view. Choose the sibling TVL-specific endpoint if you only need granular TVL breakdown components.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:18.304Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-historical-apy-tvl-6cc1639b"}