# 2s.io DeFi Protocol TVL History

> 2s.io DeFi Protocol TVL History is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-09-15).

Returns a daily time series of total value locked (TVL in USD) for a named DeFi protocol, sourced from DefiLlama, with up to 1000 historical data points.

## Facts

- Endpoint: GET https://2s.io/api/crypto/defi-protocol-history
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-defi-protocol-tvl-history-329c7ff6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EuPUHILRAa26xQ7dGBMZR

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 2s-io-defi-protocol-tvl-history-329c7ff6
```

Example prompt: Can you pull the last 180 days of daily TVL history for the Lido protocol and chart how it's grown or declined over time?

## When to prefer this

Use this endpoint when you need a historical time series of TVL (not just a current snapshot) for a specific DeFi protocol by its DefiLlama slug. Prefer this over crypto.defi (current TVL only) when you need trend analysis, charting, or growth/decline tracking over days, weeks, or months. It is free and keyless, making it ideal for lightweight agent workflows.

## Known failure modes

- Invalid or unrecognized protocol slug returns empty or error response
- Limit parameter out of range (< 1 or > 1000) causes validation error
- Protocol has insufficient history for the requested limit — fewer points returned
- DefiLlama upstream unavailable — service may return 503 or empty data
- Misspelled slug (e.g. 'aave-v2' vs 'aave') returns no data

## How this service works

Historical total-value-locked (TVL) time series for a DeFi protocol by slug (e.g. aave, lido, uniswap), via DefiLlama (free/keyless). Returns daily { date, tvlUsd } points (most recent N, default 90) plus the protocol's chains. For charting a protocol's growth or decline over time. Net-new vs crypto.defi (current TVL only).

## Output

An array of daily {date, tvlUsd} data points (up to the requested limit, default 90) for the specified DeFi protocol slug, plus the list of blockchain networks (chains) the protocol is deployed on. Data is sourced from DefiLlama and is free/keyless.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string",
       "maxLength": 80,
       "minLength": 1,
       "description": "DefiLlama protocol slug, e.g. aave, lido, uniswap."
      },
      "limit": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1,
       "description": "Most-recent N daily points (default 90)."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-defi-protocol-tvl-history-329c7ff6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)