{"uid":"cap_rNRIUh-oLM7_3hMxGUF-a","slug":"defi-liquidity-pool-apy-tvl-history-6f9f2d80","name":"DeFi Liquidity Pool APY & TVL History","description":"History of one liquidity pool's APY and TVL (by its pool id, the 'id' field returned by the DeFi yields service): current, average, min and max APY over the period, current TVL, whether the yield is stable or a one-off spike, and a sampled series. Live from DefiLlama.","url":"https://api.vextorium.com/pool-historico-pago?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":["pool_id"],"properties":{"dias":{"type":"integer","maximum":365,"minimum":7,"description":"Look-back window in days (7-365, default 90)"},"pool_id":{"type":"string","description":"Pool id (the 'id' field from the DeFi yields service)"}}},"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":{"dias":{"type":["number","null"]},"nota":{"type":["string","null"]},"serie":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"fecha":{"type":["null","string"]},"apy_pct":{"type":["null","number"]},"tvl_usd":{"type":["null","number"]}}}},"estable":{"type":["string","null"]},"pool_id":{"type":["string","null"]},"apy_max_pct":{"type":["number","null"]},"apy_min_pct":{"type":["number","null"]},"apy_medio_pct":{"type":["number","null"]},"apy_actual_pct":{"type":["number","null"]},"tvl_actual_usd":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"dias":90,"nota":"APY medio y su variación dicen si el rendimiento es real y sostenido o un pico puntual. Fuente: DefiLlama.","serie":[{"fecha":"2026-07-03","apy_pct":5.17,"tvl_usd":3170318295},{"fecha":"2026-07-10","apy_pct":4.89,"tvl_usd":3336696799},{"fecha":"2026-07-17","apy_pct":4.83,"tvl_usd":3192435331},{"fecha":"2026-07-24","apy_pct":4.82,"tvl_usd":2547268182},{"fecha":"2026-07-31","apy_pct":5.15,"tvl_usd":2527406101},{"fecha":"2026-08-07","apy_pct":4.87,"tvl_usd":2738924439},{"fecha":"2026-08-14","apy_pct":4.82,"tvl_usd":2551585211},{"fecha":"2026-08-21","apy_pct":4.81,"tvl_usd":2879873100},{"fecha":"2026-08-28","apy_pct":4.95,"tvl_usd":2687489461},{"fecha":"2026-09-04","apy_pct":5.03,"tvl_usd":2713340583},{"fecha":"2026-09-11","apy_pct":4.96,"tvl_usd":2629252997},{"fecha":"2026-09-18","apy_pct":4.97,"tvl_usd":2705134386},{"fecha":"2026-09-25","apy_pct":5.26,"tvl_usd":2922283584}],"estable":"sí","pool_id":"43641cf5-a92e-416b-bce9-27113d3c0db6","apy_max_pct":5.26,"apy_min_pct":4.8,"apy_medio_pct":4.96,"apy_actual_pct":5.14,"tvl_actual_usd":2871719879}},"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_DUTajrGF8sUBZEW9QO5vi","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 historical APY and TVL statistics for a specific DeFi liquidity pool over a configurable look-back window, sourced live from DefiLlama.","exampleAgentPrompt":"Pull the APY and TVL history for DefiLlama pool id '747c1d2a-c668-4682-b9f9-296708a3dd90' over the last 60 days — I want to see the current, average, min and max APY, the current TVL, whether the yield is stable, and a sampled time series.","exampleUseCases":[{"title":"Evaluating pool yield stability before investing","prompt":"Look up the APY history for this liquidity pool (id: 'aa3c3a6a-dc4c-4028-9e3d-28a9f1f47d2e') over the last 90 days — is the yield stable or just a temporary spike, and what's the average APY vs the current one?"},{"title":"Monitoring a pool's TVL trend over 30 days","prompt":"Get me the TVL and APY stats for DefiLlama pool 'b4a3c7e1-11f2-4bcd-a982-dcf12345abcd' for the past 30 days — I want the current TVL, how the APY has moved, and a sampled series so I can chart it."},{"title":"Comparing current APY against historical range","prompt":"For pool id '5b7f1a22-9c3d-4e0b-8765-abcdef123456', show me the min and max APY over the last 180 days alongside the current rate — I want to know if we're near the historical peak or trough."}],"resultDescription":"Returns a JSON object containing: current APY (apy_actual_pct), average APY (apy_medio_pct), min APY (apy_min_pct), max APY (apy_max_pct), current TVL in USD (tvl_actual_usd), a stability flag (estable) indicating whether the yield is consistent or a one-off spike, the pool_id, number of days in the look-back window, an optional note (nota), and a sampled time series (serie) with daily date, APY percentage, and TVL in USD.","failureModes":["Invalid or unknown pool_id returns null or empty result","Pool with insufficient historical data may return incomplete series","dias value outside 7–365 range is rejected by schema validation","DefiLlama data unavailability may cause stale or missing results","Network timeout if DefiLlama upstream is slow"],"whenToPreferThis":"Use this endpoint when you need historical APY and TVL analytics for a specific DeFi liquidity pool identified by its DefiLlama pool id. It is ideal for yield stability analysis, trend monitoring, and comparing current rates against historical min/max. Prefer it over generic DeFi APIs when you need DefiLlama-sourced data with a configurable look-back window and a stability classification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:46:23.745Z","isFirstParty":false,"canonicalSlug":"defi-liquidity-pool-apy-tvl-history-6f9f2d80"}