# DeFi TVL History

> DeFi TVL History is a paid API for AI agents from santyvv-x402.santyvv1993.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-01).

Returns historical Total Value Locked (TVL) data for DeFi protocols across all chains or a specific blockchain

## Facts

- Endpoint: GET https://santyvv-x402.santyvv1993.workers.dev/api/defi/tvl-history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-history-80d59687
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PMxpU6qxvnCJrcfNqnrII

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-tvl-history-80d59687
```

Example prompt: Can you pull up the historical DeFi TVL data across all chains so I can see how total value locked has trended over time?

## When to prefer this

Use this endpoint when you need historical TVL trend data for DeFi protocols rather than current snapshot data. Ideal for charting DeFi market size over time, comparing chain-level DeFi growth, or building reports that require time-series TVL data. Prefer this over spot price or market cap endpoints when the user's question is specifically about DeFi protocol liquidity or total locked value history.

## Known failure modes

- Invalid or unsupported chain name returns an error or empty dataset
- No data available for very recent timestamps if indexing is delayed
- Payment failure if USDC balance is insufficient for the $0.01 per-call fee
- Rate limiting if too many requests are made in quick succession

## How this service works

DeFi TVL history, all chains or one chain

## Output

A time-series dataset of Total Value Locked (TVL) figures, either aggregated across all chains or filtered to a specific blockchain, with timestamps and TVL values in USD allowing historical trend analysis.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-history-80d59687/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from santyvv-x402.santyvv1993.workers.dev](https://www.zero.xyz/host/santyvv-x402.santyvv1993.workers.dev/llms.txt)