# DeFi TVL & Protocol Data via DefiLlama

> DeFi TVL & Protocol Data via DefiLlama is a paid API for AI agents from api.kadec0.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns total-value-locked (TVL), category, chain presence, and change metrics for DeFi protocols or chains via DefiLlama

## Facts

- Endpoint: GET https://api.kadec0.xyz/v1/defi-tvl
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-protocol-data-via-defillama-9b73cbef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JWQmjL_mK4fbp7qBVTw83

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 defi-tvl-protocol-data-via-defillama-9b73cbef
```

Example prompt: What are the top 10 lending protocols by TVL on Ethereum right now — show me their total value locked and any recent changes?

## When to prefer this

Use this endpoint when you need current TVL figures, protocol rankings, or chain-level DeFi data sourced from DefiLlama. Prefer it over generic crypto price APIs when the question is specifically about locked value, protocol categories, or cross-chain DeFi presence. The filtering by category (Dexes, Lending, CDP) and chain makes it especially useful for targeted DeFi research.

## Known failure modes

- No protocols match the name filter — returns empty list
- Invalid category string returns no results or error
- Unsupported mode value returns validation error
- DefiLlama upstream unavailable — service returns 502 or error
- maxItems too large may slow response or be capped

## How this service works

DeFi TVL for protocols and chains. Returns total value locked per DeFi protocol or per chain via DefiLlama, with category, supported chains, and TVL change over time, filterable by category or chain. For DeFi protocol screening, chain-level TVL comparison, and tracking where liquidity is moving. Keyless.

## Output

A list of DeFi protocols or chains with their total value locked (TVL), protocol category (e.g. Dexes, Lending, CDP), which chains they operate on, and TVL change metrics — sourced from DefiLlama.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "name substring filter"
      },
      "mode": {
       "enum": [
        "protocols",
        "chains"
       ],
       "type": "string",
       "default": "protocols"
      },
      "chain": {
       "type": "string",
       "description": "protocol must touch this chain"
      },
      "category": {
       "type": "string",
       "description": "exact category, e.g. Dexes|Lending|CDP"
      },
      "maxItems": {
       "type": "string",
       "default": "25"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-protocol-data-via-defillama-9b73cbef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kadec0.xyz](https://www.zero.xyz/host/api.kadec0.xyz/llms.txt)