# Daily TVL History for One Chain (Up to 2 Years)

> Daily TVL History for One Chain (Up to 2 Years) is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-03).

Returns daily Total Value Locked (TVL) history for a specified blockchain, covering up to 730 days of data.

## Facts

- Endpoint: POST https://twin.unykorn.org/defi/chain-tvl-history?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/daily-tvl-history-for-one-chain-up-to-2-years-e6dc1e81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wz9zuFaqnNOSrXXwyfapB

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 daily-tvl-history-for-one-chain-up-to-2-years-e6dc1e81 -d '<json body>'
```

Example prompt: Can you pull the daily TVL history for Ethereum over the last 365 days so I can see how DeFi activity has trended on that chain?

## When to prefer this

Use this endpoint when you need per-day TVL granularity for a single blockchain over a medium-to-long historical window (up to 2 years). It is ideal for trend analysis, charting DeFi growth, or generating time-series reports for a specific chain. If you need cross-chain TVL comparison, multi-protocol breakdowns, or real-time snapshots, consider other endpoints in the same network.

## Known failure modes

- Missing or unrecognized chain name returns an error or empty result
- Days parameter outside 2–730 range is rejected with a validation error
- Chain with no DeFi data tracked may return an empty or sparse series
- Payment failure via x402 protocol prevents access to data
- Upstream DeFi data provider outage may cause stale or unavailable data

## How this service works

Daily TVL history for one chain (up to 2 years) — Genesis402 / UnyKorn Operator Network

## Output

A time series of daily TVL values for the requested blockchain, covering up to 730 days. Each data point includes a date and the corresponding total value locked in USD for that chain, enabling trend analysis and historical comparison.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "days": {
     "type": "integer",
     "maximum": 730,
     "minimum": 2,
     "description": "optional 2-730, default 90"
    },
    "chain": {
     "type": "string",
     "description": "required: chain name, e.g. Ethereum"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "defi-chain-tvl-history",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.003,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/daily-tvl-history-for-one-chain-up-to-2-years-e6dc1e81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)