# Agent402 DeFi Chain TVL Lookup

> Agent402 DeFi Chain TVL Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns ranked DeFi chain data including TVL, chain ID, token symbol, and market share, sourced from DeFiLlama, with optional filtering by name or minimum TVL.

## Facts

- Endpoint: POST https://agent402.tools/api/defi-chains
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-defi-chain-tvl-lookup-453f93f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QzQ3M3mgVi1zItcaEk-sr

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 agent402-defi-chain-tvl-lookup-453f93f3 -d '<json body>'
```

Example prompt: Show me the top 10 DeFi blockchains by TVL — I want to see their chain IDs, market share percentages, and token symbols.

## When to prefer this

Use this endpoint when you need current, ranked DeFi chain TVL data with flexible filtering by name or minimum TVL threshold. Prefer this over general web search when you need structured, machine-readable chain metrics including chain IDs and CoinGecko IDs for downstream lookups. Ideal for agents doing DeFi portfolio analysis, chain comparison, or routing decisions based on liquidity depth.

## Known failure modes

- No chains match the search substring — returns empty chains array with count 0
- minTvlUsd set too high filters out all results — returns empty list
- limit exceeds max of 100 — may be clamped or rejected
- DeFiLlama upstream unavailable — may return stale cached data or error
- Invalid input types (e.g. non-numeric minTvlUsd) — returns validation error

## How this service works

Blockchains ranked by DeFi total value locked with each chain's share of the total, native token, EVM chain id and CoinGecko id. Use it when an agent is comparing chains by DeFi activity or needs the canonical ids to query other services about a chain.

## Output

Returns a JSON object with a list of DeFi chains sorted by rank, each containing name, TVL in USD, chain ID, CoinGecko ID, market share percentage, and token symbol. Also includes aggregate totals (total chain count and total TVL across all chains), a matched count, cache status, data source attribution, and a fetch timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Rows to return (default 25, max 100)."
  },
  "search": {
   "type": "string",
   "description": "Chain name substring (case-insensitive)."
  },
  "minTvlUsd": {
   "type": "number",
   "description": "Minimum chain TVL in USD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "cached": false,
  "chains": [
   {
    "name": "Ethereum",
    "rank": 1,
    "tvlUsd": 70000000000,
    "chainId": 1,
    "geckoId": "ethereum",
    "sharePct": 58.3,
    "tokenSymbol": "ETH"
   }
  ],
  "source": "defillama-chains",
  "totals": {
   "chainCount": 462,
   "totalTvlUsd": 120000000000
  },
  "matched": 462,
  "fetchedAt": "2026-08-22T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-defi-chain-tvl-lookup-453f93f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)