# DeFi Protocol TVL (Filtered)

> DeFi Protocol TVL (Filtered) is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Returns a filtered, server-side-reduced list of DeFi protocols with current TVL, 1d/7d changes, market cap, chain, and category — queryable by chain, category, min TVL, sort order, and limit.

## Facts

- Endpoint: GET https://x402.shizu.me/llama/protocols
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-filtered-16f1fd66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MC1LAjYAEt1mPhh3v5tCJ

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-filtered-16f1fd66
```

Example prompt: Can you pull the top 20 DeFi lending protocols on Ethereum, sorted by TVL, with a minimum of $10M TVL — I want to see their names, current TVL, and 7-day change?

## When to prefer this

Use this endpoint when you need a filtered, ranked snapshot of DeFi protocols by TVL without downloading the full 8.5MB DefiLlama raw index. Ideal for leaderboards, screeners, research summaries, or agent workflows that need to identify top protocols by chain, category, or growth rate. Prefer over the raw DefiLlama index when bandwidth, latency, or payload size matter. Pair with /llama/tvl for live single-number polling of a specific protocol once you have its slug.

## Known failure modes

- Invalid chain name returns empty result set or 400 error
- Unsupported category string may return no results
- min_tvl above existing protocol TVLs returns an empty list
- sort parameter value outside allowed enum returns an error
- limit outside 1-100 range may be rejected or clamped
- Payment failure (x402) blocks access before query is processed

## How this service works

Every DefiLlama protocol with current TVL, filtered server-side (the raw index is 8.5MB). Query: chain, category (Lending, Dexes, ...), min_tvl (USD), sort (tvl|change_1d|change_7d), limit (1-100). Each: name, slug, chain, category, tvl_usd, change_1d, change_7d, mcap. Use the slug with /llama/tvl for a live single-number poll.

## Output

A filtered list of up to 100 DeFi protocols, each including: protocol name, slug (usable with /llama/tvl for live single-number polling), chain, category (e.g. Lending, Dexes), current TVL in USD, 1-day TVL change percentage, 7-day TVL change percentage, and market cap. Results are pre-filtered and sorted server-side to avoid the full 8.5MB raw index payload.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category",
      "sort",
      "limit"
     ],
     "properties": {
      "sort": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "category": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "source": "defillama",
  "protocols": [
   {
    "mcap": null,
    "name": "Aave V3",
    "slug": "aave-v3",
    "chain": "Multi-Chain",
    "tvl_usd": 13900000000,
    "category": "Lending",
    "change_1d": 0.4,
    "change_7d": -1.7
   }
  ],
  "total_protocols": 6883
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-protocol-tvl-filtered-16f1fd66/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)