# Chain TVL History

> Chain TVL History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-28).

Returns the TVL history of a blockchain including current value, all-time high, distance from ATH, 30d/1y changes, and a sampled time series, sourced from DefiLlama.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/chain-tvl-history?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chain-tvl-history-b7236a00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YhglSPyqga817N_x3bZoR

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 chain-tvl-history-b7236a00 -d '<json body>'
```

Example prompt: Pull the TVL history for Ethereum over the last 365 days — I want the current TVL, its all-time high and when that was, how far it is from the ATH, and the 30-day and 1-year percentage changes.

## When to prefer this

Use this endpoint when you need historical TVL context for a specific blockchain — especially cycle position (distance from ATH), trend direction (30d/1y changes), and a time series for charting. Prefer this over a simple current-TVL lookup when the user wants to understand momentum, recovery, or where a chain stands relative to its peak. It is more focused than a full cross-chain rankings endpoint and more detailed than a snapshot metric.

## Known failure modes

- Unknown or misspelled chain name returns null or error
- Look-back window outside 30–2000 day range returns validation error
- DefiLlama data temporarily unavailable causes empty or null series
- Chain with no DeFi activity returns zero or null TVL values
- Very new chains may have insufficient history for the full requested window

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing the chain name, current TVL in USD, historical maximum TVL in USD and its date, percentage distance from ATH, 30-day % change, 1-year % change, a note, and a sampled time series of date/TVL pairs covering the requested look-back window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "maximum": 2000,
   "minimum": 30,
   "description": "Look-back window in days (30-2000, default 365)"
  },
  "chain": {
   "type": "string",
   "description": "Chain name, e.g. Ethereum, Base, Solana, Arbitrum"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Chain TVL history. The distance from the peak shows where it is in the cycle. Source: DefiLlama.",
  "chain": "Ethereum",
  "series": [
   {
    "date": "2025-10-01",
    "tvl_usd": 87979353983
   },
   {
    "date": "2025-10-31",
    "tvl_usd": 84255331431
   }
  ],
  "max_date": "2021-11-09",
  "change_1y_pct": -40.24,
  "since_max_pct": -50.84,
  "change_30d_pct": 8.32,
  "current_tvl_usd": 52830721315,
  "historical_max_usd": 107458598469
 }
}
```

## More

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