# DeFi TVL by Chain

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

Returns total DeFi TVL (Total Value Locked) for every blockchain tracked by DefiLlama, ranked by TVL in USD.

## Facts

- Endpoint: GET https://x402.shizu.me/llama/chains
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-by-chain-8ed01b40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VzyR1CXKC3uZDZZtl4ie2

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-by-chain-8ed01b40
```

Example prompt: Show me the top 25 blockchains ranked by DeFi TVL, including the name, TVL in USD, and native token for each.

## When to prefer this

Use this endpoint when you need a ranked, cross-chain TVL snapshot sourced from DefiLlama — especially when comparing multiple chains at once or building a market-wide overview. Prefer this over single-chain RPC calls when you don't need per-protocol breakdowns, just chain-level aggregates. Useful for quick ranking queries where freshness matters but protocol-level granularity does not.

## Known failure modes

- limit out of range (must be 1–500): returns error
- Payment not provided or insufficient USDC balance: 402 Payment Required
- DefiLlama upstream data unavailable: may return stale or empty data
- Network timeout: transient 5xx error

## How this service works

Total DeFi TVL for every chain DefiLlama tracks, ranked. Query: limit (1-500). Each: name, tvl_usd, token.

## Output

A ranked list of blockchain entries, each containing the chain name, total TVL in USD, and the chain's native token. Results are ordered from highest to lowest TVL. The number of chains returned is controlled by the `limit` parameter (1–500).

## 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": [
      "limit"
     ],
     "properties": {
      "limit": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "chains": [
   {
    "name": "Ethereum",
    "token": "ETH",
    "tvl_usd": 41465846538
   }
  ],
  "source": "defillama"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-by-chain-8ed01b40/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)