# DeFi Protocol TVL History (via DefiLlama)

> DeFi Protocol TVL History (via DefiLlama) 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-20).

Returns up to 5 years of daily TVL history for a named DeFi protocol, including percentage changes, all-time high, drawdown, and current TVL broken down by chain.

## Facts

- Endpoint: POST https://api.vextorium.com/protocolo-historico-pago?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-history-via-defillama-764495b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z7pep-iffQ4nN5opb4iQz

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-protocol-tvl-history-via-defillama-764495b0 -d '<json body>'
```

Example prompt: Pull the last 90 days of TVL history for Lido, including the 7, 30, 90, and 365-day percentage changes, the all-time high and how far it's dropped from there, and the current TVL split across chains.

## When to prefer this

Choose this endpoint when you need structured historical TVL data — including trend analysis, ATH/drawdown metrics, and per-chain breakdown — for any DeFi protocol tracked by DefiLlama. It is ideal for research, reporting, and monitoring workflows. Prefer it over direct DefiLlama API calls when you need a single, normalized, payment-gated response that already computes change percentages and ATH drawdown for you.

## Known failure modes

- Unknown protocol slug returns an error or null data
- Days parameter outside 7–1825 range may return validation error
- Protocol with no TVL history on DefiLlama returns empty series
- Network or DefiLlama upstream timeout causes delayed or failed response
- Payment failure (insufficient USDC balance) blocks the request

## How this service works

TVL history of a DeFi protocol (up to 5 years): series, 7/30/90/365-day change, all-time high and drawdown from it, and current TVL by chain. Live from DefiLlama.

## Output

Returns a JSON object with: the protocol slug and display name, today's date, a daily TVL series (array of date + TVL in USD), percentage changes at 7, 30, 90, and 365-day intervals, current total TVL in USD, TVL distributed across named chains (Ethereum, Arbitrum, Base, Polygon, Optimism, etc.), and the all-time high record (date, TVL, and percentage drop from it). Data is sourced live from DefiLlama.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "dias": {
   "type": "integer",
   "description": "Days of series (7-1825, default 365)"
  },
  "nombre": {
   "type": "string",
   "description": "Protocol, e.g. aave, lido, uniswap"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "slug": "aave-v3",
  "fecha": "2026-10-02",
  "serie": [
   {
    "fecha": "2026-07-05",
    "tvl_usd": 12859246586
   },
   {
    "fecha": "2026-07-06",
    "tvl_usd": 12889768625
   }
  ],
  "fuente": "DefiLlama",
  "tvl_usd": 18513893247,
  "protocolo": "Aave V3",
  "cambio_pct": {
   "7d": 1.23,
   "30d": 8.59,
   "90d": 45.35,
   "365d": -58.12
  },
  "por_cadena": {
   "Base": 572676307,
   "xDai": 60119328,
   "Linea": 9580388,
   "Monad": 321958922,
   "Sonic": 6093686,
   "Mantle": 57317958,
   "Plasma": 438261046,
   "Binance": 215561732,
   "MegaETH": 12238169,
   "Polygon": 149483827,
   "X Layer": 117094427,
   "Arbitrum": 537483919,
   "Ethereum": 15600173708,
   "Optimism": 55519034,
   "Avalanche": 353527979
  },
  "maximo_historico": {
   "fecha": "2025-10-07",
   "tvl_usd": 45443859638,
   "caida_desde_maximo_pct": -59.26
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-protocol-tvl-history-via-defillama-764495b0/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)