# santyvv-data: Chain TVL History

> santyvv-data: Chain 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 the historical Total Value Locked (TVL) time series for a specific blockchain network

## Facts

- Endpoint: GET https://santyvv-x402.santyvv1993.workers.dev/api/defi/chain-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/santyvv-data-chain-tvl-history-584e7cd1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__ZTUqU8C0Ns-equ0EzV1U

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 santyvv-data-chain-tvl-history-584e7cd1
```

Example prompt: Can you pull up the historical TVL data for the Ethereum chain so I can see how total value locked has changed over time?

## When to prefer this

Use this endpoint when you need historical TVL data for a single specific blockchain chain, particularly for DeFi analytics, ecosystem health monitoring, or investment research. It complements other endpoints in this suite that cover coin prices and market cap history. Choose this over general market data endpoints when the focus is on on-chain DeFi liquidity and protocol adoption trends.

## Known failure modes

- Unknown or unsupported chain identifier returns empty or error response
- Missing required chain query parameter causes a 400 bad request
- Payment not processed results in 402 Payment Required response
- Rate limiting may occur if called too frequently
- Chain name typos or incorrect casing may yield no results

## How this service works

TVL history for one chain

## Output

A time series of Total Value Locked (TVL) values for the specified blockchain chain, including historical data points with timestamps and TVL amounts in USD, enabling trend analysis and DeFi ecosystem monitoring.

## 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/santyvv-data-chain-tvl-history-584e7cd1/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)