# Tanod chainpeek DeFi TVL

> Tanod chainpeek DeFi TVL is a paid API for AI agents from tanod.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-18).

Returns total value locked (TVL) for a DeFi protocol or chain, with 1-day and 7-day percentage changes, sourced from cached DefiLlama data.

## Facts

- Endpoint: POST https://tanod.dev/v1/defi/tvl?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-defi-tvl-1dbdf1d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pzAKMlbFg3WQUxm_h5kc3

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 tanod-chainpeek-defi-tvl-1dbdf1d3 -d '<json body>'
```

Example prompt: What is Aave's current TVL and how has it changed over the last 1 and 7 days? Also show me the top 5 protocols on Ethereum by TVL.

## When to prefer this

Use this endpoint when an agent needs to size or compare DeFi protocols or chains by TVL, track TVL momentum (1-day or 7-day changes), or rank protocols within a specific chain. Prefer this over raw DefiLlama API calls when a cached, low-latency, pay-per-call option is acceptable. Best suited for research, monitoring, and decision-support workflows where near-real-time TVL data is sufficient.

## Known failure modes

- Unknown protocol name returns HTTP 422 with suggested alternatives
- Unknown or misspelled chain name returns an error
- Cached data may be slightly stale (not real-time)
- Limit parameter outside 1-50 range causes validation error
- Both protocol and chain omitted may return a general overview rather than a specific result

## How this service works

chainpeek (Tanod) DeFi TVL: total value locked of a protocol or chain with 1-day and 7-day change, from cached DefiLlama data. Use when an agent must size or compare a DeFi protocol or chain: its TVL and the 1-day and 7-day change.

## Output

Returns the TVL in USD for the requested protocol and/or chain, along with percentage change over the past 1 day and 7 days. When querying a chain alone, also returns a ranked breakdown of the largest protocols on that chain (up to the specified limit). Data is sourced from DefiLlama via cache.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^.*[A-Za-z0-9].*$",
     "maxLength": 80,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Chain name, e.g. Ethereum, Base, Solana, BSC, Arbitrum (common aliases such as bnb and eth work). With protocol: that protocol's TVL on the chain. Alone: the chain and its largest protocols."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1,
   "description": "Rows in a ranking or a breakdown, 1-50 (default 10)."
  },
  "protocol": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^.*[A-Za-z0-9].*$",
     "maxLength": 80,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Protocol name or slug, e.g. aave, uniswap-v3, lido (a parent such as aave sums its versions). Omit for a chain or the overview. An unknown name is a 422 with suggestions."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-chainpeek-defi-tvl-1dbdf1d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)