# DeFi Liquidity Pool APY & TVL History > DeFi Liquidity Pool APY & TVL History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-01). Returns historical APY and TVL statistics for a specific DeFi liquidity pool over a configurable look-back window, sourced live from DefiLlama. ## Facts - Endpoint: POST https://api.vextorium.com/pool-historico-pago?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-01 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/defi-liquidity-pool-apy-tvl-history-6f9f2d80 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rNRIUh-oLM7_3hMxGUF-a Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability defi-liquidity-pool-apy-tvl-history-6f9f2d80 -d '' ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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" ] } } … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-liquidity-pool-apy-tvl-history-6f9f2d80/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)