{"uid":"cap_pXnxNHHS1n2cUVJBPdLEG","slug":"agent402-defi-yield-history-304bae60","name":"Agent402 DeFi Yield History","description":"Daily APY and TVL history for one yield pool, up to ten years, with a summary of latest, minimum, maximum and mean APY and the TVL change over the window. Use it when an agent is judging whether a pool's current yield is typical or an outlier before allocating to it.","url":"https://agent402.tools/api/defi-yield-history","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pool":{"type":"string","description":"DefiLlama pool id (UUID) as returned by defi-yields."},"limit":{"type":"number","description":"Most recent days to return (default 90, max 3650)."}}},"responseSchema":{"type":"json","example":{"pool":"54e9b138-3146-4c1f-8dce-1cb948f5ef96","count":2,"points":[{"apy":3.6,"date":"2026-08-21","tvlUsd":548000000,"apyBase":null,"apyReward":3.6},{"apy":3.51,"date":"2026-08-22","tvlUsd":546610322,"apyBase":null,"apyReward":3.51}],"source":"defillama-yields","summary":{"apy":{"max":3.9,"min":3.2,"mean":3.6,"first":3.9,"latest":3.51,"changePct":-10},"tvlUsd":{"max":580000000,"min":540000000,"mean":560000000,"first":579045934,"latest":546610322,"changePct":-5.6}},"fetchedAt":"2026-08-22T12:00:00.000Z","totalPoints":170}},"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_tlEgRK-hlzz8_thrGTPmv","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 daily APY and TVL data points for a specific DeFi liquidity pool over a configurable time window, sourced from DefiLlama.","exampleAgentPrompt":"Pull the last 180 days of daily APY and TVL history for DefiLlama pool 54e9b138-3146-4c1f-8dce-1cb948f5ef96 so I can see how the yield has trended.","exampleUseCases":[{"title":"Yield trend analysis for DeFi position","prompt":"Show me the daily APY and TVL history for DefiLlama pool 54e9b138-3146-4c1f-8dce-1cb948f5ef96 over the past 90 days — I want to see the min, max, and average yield."},{"title":"Long-term pool performance review","prompt":"Get me 365 days of APY history for pool a1b2c3d4-0000-1111-2222-333344445555 on DefiLlama so I can evaluate how stable the yield has been over the past year."},{"title":"Monitoring recent APY drop","prompt":"Has the APY for DefiLlama pool 54e9b138-3146-4c1f-8dce-1cb948f5ef96 dropped significantly in the last 30 days? Pull the daily history so I can see the percent change from the start to now."}],"resultDescription":"Returns a JSON object containing the pool UUID, a count of data points, an array of daily records (each with date, APY, APY base, APY reward, and TVL in USD), summary statistics for APY and TVL (min, max, mean, first, latest, changePct), the data source ('defillama-yields'), a fetchedAt timestamp, and the total number of historical points available.","failureModes":["Invalid or unknown pool UUID returns an error or empty result","Limit exceeds 3650 days and may be capped or rejected","Pool has insufficient history for the requested window, returning fewer points than expected","DefiLlama upstream unavailability causes stale or missing data","Malformed UUID format causes a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need structured daily time-series data for APY and TVL for a specific DeFi liquidity pool identified by its DefiLlama pool UUID. It is ideal for trend analysis, volatility assessment, and performance benchmarking over custom time windows up to 10 years. Prefer it over generic DeFi APIs when you already have the pool UUID (e.g., from the defi-yields endpoint on the same platform) and need rich summary statistics alongside raw data points.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:51.164Z","isFirstParty":false}