# DefiLlama Chain TVL Lookup (x402)

> DefiLlama Chain TVL Lookup (x402) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Returns real-time TVL (Total Value Locked) data for a specific blockchain or across all DeFi chains, with rankings, flow signals, and change metrics, paid via x402 micropayment.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/defillama/chain-tvl?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-chain-tvl-lookup-x402-b12b3093
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fVaKLWajVzFGAduVrrX7s

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 defillama-chain-tvl-lookup-x402-b12b3093
```

Example prompt: What's Base's current TVL, its rank among all chains, and how has it changed over the past week?

## When to prefer this

Choose this endpoint when an AI agent needs real-time DeFi TVL data for one or more blockchains without managing API keys, paid via USDC micropayment on Base. Ideal for trading agents, onchain analytics bots, or any workflow needing authoritative chain TVL rankings and trend signals from DefiLlama.

## Known failure modes

- Unknown chain name returns empty or error response
- Limit parameter exceeding 50 returns validation error
- Stale data if DefiLlama upstream is delayed
- x402 payment failure if wallet has insufficient USDC on Base
- Invalid protocol slug returns no protocol-specific data

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

Returns a JSON object with chain-level TVL in USD, rank, share of total DeFi, 1d/7d/30d percentage changes, flow direction (flat/inflow/outflow), a NEUTRAL/BULLISH/BEARISH signal, global DeFi totals, a ranked list of top chains, and a timestamp. Also includes suggested next endpoints.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "examples": [
        "Base",
        "Ethereum"
       ],
       "maxLength": 40,
       "description": "Chain name, e.g. Base, Ethereum, Solana"
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Top chains to list (default 15)"
      },
      "protocol": {
       "type": "string",
       "examples": [
        "aave"
       ],
       "maxLength": 60,
       "description": "DefiLlama protocol slug, e.g. aave, lido, aerodrome"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "defi": {
   "base": {
    "rank": 5,
    "tvl_usd": 3900000000,
    "share_pct": 3.1
   },
   "flow": "flat",
   "change_1d_pct": 0.3,
   "change_7d_pct": -2.1,
   "total_tvl_usd": 125000000000,
   "chains_counted": 300,
   "change_30d_pct": 4
  },
  "next": [
   "/crypto/global-market",
   "/crypto/stablecoin-peg"
  ],
  "chain": {
   "flow": "flat",
   "name": "Base",
   "rank": 5,
   "as_of": "2026-10-30",
   "tvl_usd": 3900000000,
   "chain_id": 8453,
   "change_1d_pct": 0.4,
   "change_7d_pct": -1.2,
   "change_30d_pct": 5.6,
   "share_of_defi_pct": 3.1
  },
  "signal": "NEUTRAL",
  "source": "https://defillama.com",
  "reasons": [
   "DeFi TVL $125.0B, 7d -2.1%",
   "Base #5 $3.90B, 7d -1.2% (flat)"
  ],
  "top_chains": [
   {
    "name": "Ethereum",
    "rank": 1,
    "token": "ETH",
    "tvl_usd": 70000000000,
    "share_pct": 56
   }
  ],
  "updated_at": "2026-10-30T02:30:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-chain-tvl-lookup-x402-b12b3093/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)