# Agent402 DeFi Protocols Lookup

> Agent402 DeFi Protocols 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-14).

Returns ranked DeFi protocol data (TVL, market cap, chains, category) filtered by chain, category, TVL, or name, sourced from DefiLlama.

## Facts

- Endpoint: POST https://agent402.tools/api/defi-protocols
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-defi-protocols-lookup-cdf1ea33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZwVh2CveQn4mXV883GwDk

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-protocols-lookup-cdf1ea33 -d '<json body>'
```

Example prompt: Show me the top 10 lending protocols on Ethereum ranked by TVL, with at least $500 million TVL each.

## When to prefer this

Use this endpoint when you need live, ranked DeFi protocol data filtered by chain, category, or TVL threshold — especially when building DeFi dashboards, agent workflows that select protocols by criteria, or research tasks comparing protocol metrics. Prefer this over manual DefiLlama API calls when you want a pay-per-call, no-auth-key approach with structured filtering built in.

## Known failure modes

- Invalid chain name not recognized by DefiLlama returns empty or unfiltered results
- Category string mismatch (case-sensitive expectations) may return zero results
- Limit exceeding 100 is clamped or rejected
- minTvlUsd filtering out all protocols returns empty array
- Upstream DefiLlama data unavailability causes stale or error response
- Malformed JSON body returns 400 error

## How this service works

DeFi protocols ranked by total value locked, filterable by category, chain or name, each with rank, chains, TVL, 1h, 1d and 7d change, market cap and the market cap to TVL ratio. Use it when an agent needs the league table of protocols or wants to find the largest lending, DEX or staking venues on a chain.

## Output

A JSON object containing the count of returned protocols, total TVL, applied filters, fetch timestamp, and an array of protocol objects each with name, slug, rank, TVL in USD, mcap/TVL ratio, market cap, supported chains, category, chain count, and 1h/1d/7d TVL percentage changes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain filter as DefiLlama names it (Ethereum, Base, Solana, Arbitrum...). Rows are then ranked by TVL on that chain."
  },
  "limit": {
   "type": "number",
   "description": "Rows to return (default 25, max 100)."
  },
  "search": {
   "type": "string",
   "description": "Name/slug substring filter (case-insensitive)."
  },
  "category": {
   "type": "string",
   "description": "Category filter (Lending, Dexs, Liquid Staking, Restaking, CDP, Yield, Derivatives, Bridge, RWA, CEX...). Case-insensitive exact match."
  },
  "minTvlUsd": {
   "type": "number",
   "description": "Minimum TVL in USD."
  },
  "includeCex": {
   "type": "boolean",
   "description": "Include centralized-exchange reserve rows (default false)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "cached": true,
  "source": "defillama-protocols",
  "filters": {
   "chain": null,
   "search": null,
   "category": "Lending",
   "minTvlUsd": null,
   "includeCex": false
  },
  "matched": 600,
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "protocols": [
   {
    "name": "Aave V3",
    "rank": 3,
    "slug": "aave-v3",
    "chains": [
     "Ethereum",
     "Base",
     "Arbitrum"
    ],
    "symbol": "AAVE",
    "tvlUsd": 17023522168,
    "mcapTvl": 0.188,
    "mcapUsd": 3200000000,
    "category": "Lending",
    "chainCount": 21,
    "change1dPct": 0.8,
    "change1hPct": 0.02,
    "change7dPct": 2.4,
    "parentProtocol": "aave"
   }
  ],
  "totalTvlUsd": 48000000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-defi-protocols-lookup-cdf1ea33/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)