# DeFi Protocol TVL

> DeFi Protocol TVL is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Look up DeFi protocols by total value locked (TVL), 1d/7d change, market cap, and chain coverage using DefiLlama data, filterable by chain and category.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/crypto/protocols?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-a13b984b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pHu6Vd2jusxQM6XYNY2sE

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-protocol-tvl-a13b984b
```

Example prompt: Show me the top 20 lending protocols ranked by TVL on Ethereum, including their 1-day and 7-day TVL changes and market caps.

## When to prefer this

Use this endpoint when you need authoritative TVL data for DeFi protocols sourced from DefiLlama, especially for protocol comparisons, chain-specific rankings, or category-level DeFi research. Prefer it over general crypto market cap APIs when the question is specifically about locked value, protocol health, or DeFi ecosystem analysis rather than token price or trading volume.

## Known failure modes

- Unknown protocol name or slug returns empty results or 404
- Invalid chain or category string returns no matches
- Limit out of range (outside 1-200) may return an error
- DefiLlama upstream outage causes stale or missing data
- Rate limiting if called excessively

## How this service works

DeFi protocols by total value locked (DefiLlama): look up one protocol (aave, uniswap, lido) or rank them by chain and category (Lending, Dexs, Liquid Staking, Bridge...) with TVL, 1d/7d change, market cap and chains. Use for DeFi research and protocol comparisons.

## Output

Returns a list of DeFi protocols with their TVL, 1-day and 7-day TVL percentage changes, market capitalization, the chains they operate on, and their DefiLlama category (e.g. Lending, Dexs, Liquid Staking, Bridge). When querying a specific protocol, returns that protocol's full detail record.

## 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": {
      "chain": {
       "type": "string",
       "description": "Chain name, e.g. Base"
      },
      "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-200)"
      },
      "category": {
       "type": "string",
       "description": "DefiLlama category, e.g. Lending"
      },
      "protocol": {
       "type": "string",
       "description": "Protocol name or slug contains"
      }
     }
    }
   },
   "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-protocol-tvl-a13b984b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)