# mcp.yield.xyz – Yield TVL History

> mcp.yield.xyz – Yield TVL History is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns time-series data of historical total-value-locked (TVL) for a specific DeFi yield, enabling analysis of inflows, outflows, and protocol growth over configurable time windows.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get_tvl_history
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mcp-yield-xyz-yield-tvl-history-4e81c3e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fus0xQI8NrsIbYcWRfE0J

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 mcp-yield-xyz-yield-tvl-history-4e81c3e3 -d '<json body>'
```

Example prompt: Show me the monthly TVL history for yield ID 'eth-lido-steth' over the last 90 days so I can see whether the protocol has been growing or shrinking.

## When to prefer this

Use this endpoint when you need historical TVL trends for a specific yield — for example to chart protocol growth, identify capital flight, compare TVL across time windows, or compute average locked value. Prefer this over the single-yield metadata endpoint when you need time-series data rather than current TVL snapshot.

## Known failure modes

- Invalid or unknown yieldId returns an error or empty result set
- Period/interval combination with no data returns empty array
- from/to date range outside available history returns partial or empty data
- limit/offset misconfiguration returns unexpected pagination behavior
- Malformed date strings in from/to fields cause validation errors

## How this service works

Historical total-value-locked (TVL) for a yield over time — track inflows/outflows and protocol growth across 1d/7d/30d/90d/1y windows.

## Output

A time-series array of TVL data points for the requested yield, each containing a timestamp and the total value locked at that point. Data is scoped to the requested period (e.g. 90d), aggregated at the chosen interval (day/week/month), and optionally bounded by from/to date filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string"
  },
  "from": {
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 365,
   "minimum": 1
  },
  "offset": {
   "type": "integer",
   "minimum": 0
  },
  "period": {
   "enum": [
    "1d",
    "7d",
    "30d",
    "90d",
    "1y",
    "all"
   ],
   "type": "string"
  },
  "yieldId": {
   "type": "string",
   "description": "Yield ID from yields_get_all"
  },
  "interval": {
   "enum": [
    "day",
    "week",
    "month"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "tvl": "124500000.12",
    "tvlRaw": "124500000120000",
    "timestamp": "2026-06-01T00:00:00.000Z"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mcp-yield-xyz-yield-tvl-history-4e81c3e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)