{"uid":"cap_wpWekgydNcsrG2ZisTGUH","slug":"vaults-fyi-historical-apy-time-series-bd4989ce","name":"Vaults.fyi Historical APY Time-Series","description":"Retrieves time-series historical APY 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/apy?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_juYsOJrKM0bncEYb1FHoK","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 APY data for a specific vault, breaking down base yield and rewards components over a customizable time range","exampleAgentPrompt":"Can you pull the historical APY breakdown for vault 0xabc123 on Ethereum from vaults.fyi, showing both base yield and rewards components over the last 90 days?","exampleUseCases":[{"title":"DeFi yield trend research","prompt":"I'm evaluating vault 0x1234abcd on Arbitrum — can you show me how its APY has trended over the past 60 days, including how much of the yield came from base rate versus incentive rewards?"},{"title":"Vault volatility risk assessment","prompt":"Pull the full APY history for vault 0xdeadbeef on Polygon over the last 6 months so I can see how volatile the yields have been before I decide to deposit."},{"title":"Yield strategy performance review","prompt":"I need to review how the base yield and rewards APY have evolved over the past quarter for vault 0x9876 on Optimism — can you get that time-series data from vaults.fyi?"}],"resultDescription":"Returns a time-series array of APY data points for the specified vault, with each entry containing a timestamp and APY values segmented into base yield and rewards components, enabling trend analysis over the requested date range.","failureModes":["Invalid network identifier returns 404 or empty result","Unknown vault ID returns not found error","Unsupported date range or malformed date parameters return 400 bad request","Network or vault combination not tracked by vaults.fyi returns empty dataset","Rate limit exceeded returns 429 error"],"whenToPreferThis":"Use this endpoint when you need granular time-series APY data for a specific vault to analyze yield trends, volatility, or the historical split between base yield and reward incentives. Prefer this over the combined APY+TVL endpoint when you specifically need APY decomposition over time without TVL data, or when you need a flexible custom time range.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:45:37.561Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-historical-apy-time-series-bd4989ce"}