# DeFi Chain TVL Rankings

> DeFi Chain TVL Rankings is a paid API for AI agents from defi.x402utils.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns a ranked list of blockchain chains by total value locked (TVL) in USD, with share percentages, for DeFi market intelligence.

## Facts

- Endpoint: GET https://defi.x402utils.workers.dev/v1/chains?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-chain-tvl-rankings-86c0d6cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B39tJAQbaTBDMmntKeSsb

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-chain-tvl-rankings-86c0d6cf
```

Example prompt: What are the top 20 blockchains ranked by total value locked in DeFi right now, and what share of the total TVL does each one hold?

## When to prefer this

Use this endpoint when you need a quick, pay-per-call lookup of DeFi chain TVL rankings without setting up a long-term API subscription. Ideal for agents that need periodic DeFi market snapshots, chain dominance comparisons, or TVL share analysis, and want to pay only for what they use via USDC micropayments on Base.

## Known failure modes

- Payment not sent or insufficient USDC balance via x402 — 402 Payment Required response
- Invalid 'top' parameter value outside 1-100 range — validation error
- Upstream data source unavailable — 5xx error with no chain data returned
- Missing or malformed x402 payment header — authentication/payment failure

## How this service works

DeFi total value locked for agents: TVL of any protocol and TVL ranking of chains. Paid per call via x402 (USDC on Base).

## Output

A JSON object containing an array of chains sorted by TVL, each with a name, TVL in USD, and share percentage of total DeFi TVL, plus the aggregate total TVL across all chains.

## 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": {
      "top": {
       "type": "string",
       "description": "how many chains (1-100)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chains": [
   {
    "name": "Ethereum",
    "tvl_usd": 55000000000,
    "share_pct": 61.1
   }
  ],
  "total_tvl_usd": 90000000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-chain-tvl-rankings-86c0d6cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi.x402utils.workers.dev](https://www.zero.xyz/host/defi.x402utils.workers.dev/llms.txt)