# DeFi Protocol TVL History

> DeFi Protocol 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-11).

Returns up to 5 years of TVL history for a named DeFi protocol, including time-series data, 7/30/90/365-day change percentages, all-time high, drawdown from ATH, and current TVL broken down by chain.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/protocol-tvl-history?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-history-edfcf18e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Kxr5-8dop8SsdFiULfZXW

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-edfcf18e -d '<json body>'
```

Example prompt: What does Aave's TVL look like over the last 90 days? I want the time series, how much it's changed over 7, 30, 90, and 365 days, the all-time high, how far it's dropped from that peak, and a breakdown by chain.

## When to prefer this

Use this endpoint when you need historical TVL data for a specific DeFi protocol, including trend analysis, ATH/drawdown context, and multi-chain breakdown. It is ideal for protocol due diligence, DeFi market research, and portfolio monitoring. Prefer this over general blockchain comparison endpoints when the focus is a single protocol's performance over time rather than chain-level aggregates.

## Known failure modes

- Unknown protocol name returns an error or empty result — use DefiLlama slug format (e.g. 'aave-v3' not 'AAVE')
- Days parameter outside 7–1825 range may be rejected or clamped
- Protocol with very short history may return fewer data points than requested
- DefiLlama upstream outage causes stale or missing data
- Some chains may return null TVL if the protocol is not deployed there

## 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 containing: the protocol's canonical slug and display name, current total TVL in USD, a daily time-series array of TVL values (up to 1825 days), percentage changes over 7, 30, 90, and 365 days, the all-time high TVL with its date and the percentage drawdown from that peak, and current TVL broken down by individual blockchain (Ethereum, Arbitrum, Base, Polygon, Optimism, Avalanche, Binance, etc.). Data is sourced live from DefiLlama.

## 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": [
      "name"
     ],
     "properties": {
      "days": {
       "type": "integer",
       "description": "Days of series (7-1825, default 365)"
      },
      "name": {
       "type": "string",
       "description": "Protocol, e.g. aave, lido, uniswap"
      }
     }
    },
    "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": {
      "date": {
       "type": [
        "string",
        "null"
       ]
      },
      "slug": {
       "type": [
        "string",
        "null"
       ]
      },
      "series": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "tvl_usd": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "tvl_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "by_chain": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "Base": {
         "type": [
          "number",
          "null"
         ]
        },
        "xDai": {
         "type": [
          "number",
          "null"
         ]
        },
        "Linea": {
         "type": [
          "number",
          "null"
         ]
        },
        "Monad": {
         "type": [
          "number",
          "null"
         ]
        },
        "Sonic": {
         "type": [
          "number",
          "null"
         ]
        },
        "Mantle": {
         "type": [
          "number",
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-02",
  "slug": "aave-v3",
  "series": [
   {
    "date": "2026-07-05",
    "tvl_usd": 12859246586
   },
   {
    "date": "2026-07-06",
    "tvl_usd": 12889768625
   }
  ],
  "source": "DefiLlama",
  "tvl_usd": 18513893247,
  "by_chain": {
   "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
  },
  "protocol": "Aave V3",
  "change_pct": {
   "7d": 1.23,
   "30d": 8.59,
   "90d": 45.35,
   "365d": -58.12
  },
  "historical_max": {
   "date": "2025-10-07",
   "tvl_usd": 45443859638,
   "drop_since_max_pct": -59.26
  }
 }
}
```

## More

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