# Agent402 DeFi Protocol Lookup

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

Fetches comprehensive DeFi protocol data from DefiLlama including TVL, market cap, chains, audits, and metadata for a given protocol slug

## Facts

- Endpoint: POST https://agent402.tools/api/defi-protocol
- 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-protocol-lookup-bd11e9f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jvj8bR5aY8Rs_7wsfDF_M

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-protocol-lookup-bd11e9f5 -d '<json body>'
```

Example prompt: Pull up the DefiLlama data for aave-v3 — I want to see its TVL, how many chains it's on, market cap, and audit info.

## When to prefer this

Use this endpoint when you need rich, structured DeFi protocol metadata from DefiLlama — including TVL, chain coverage, audits, and market metrics — for a specific protocol by its slug. Prefer this over scraping DefiLlama directly or using a general web search when you need structured JSON output suitable for programmatic analysis, comparison, or downstream agent reasoning. Best when you already know the protocol slug or can derive it.

## Known failure modes

- Invalid or unknown protocol slug returns error or empty result
- Misspelled slug (e.g. 'aavev3' instead of 'aave-v3') causes lookup failure
- Protocol not indexed by DefiLlama returns no data
- Network timeout if DefiLlama upstream is slow
- Stale cached data if protocol TVL has changed very recently

## How this service works

One DeFi protocol in full: TVL rank, TVL per chain, recent change, market cap to TVL, token, website, audits and parent, with name suggestions when the slug is unknown. Use it when an agent is researching a specific protocol and needs its size, footprint and audit status in one answer.

## Output

Returns a JSON object with comprehensive protocol data including: name, slug, TVL in USD (total and per-chain breakdown), 1h/1d/7d TVL change percentages, market cap, mcap/TVL ratio, borrowed USD, staking USD, pool2 USD, token symbol, CoinGecko ID, contract address, category, listed date, chain list, audit count and links, Twitter handle, description, logo URL, parent protocol, and cache metadata (source, fetchedAt, cached flag).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "protocol": {
   "type": "string",
   "description": "DefiLlama protocol slug (lowercase, hyphenated), e.g. aave-v3, uniswap-v3, lido, morpho-v1."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cached": true,
  "source": "defillama-protocols",
  "protocol": {
   "url": "https://aave.com",
   "logo": "https://icons.llamao.fi/icons/protocols/aave-v3",
   "name": "Aave V3",
   "rank": 3,
   "slug": "aave-v3",
   "audits": 2,
   "chains": [
    "Ethereum",
    "Base"
   ],
   "symbol": "AAVE",
   "tvlUsd": 17023522168,
   "address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
   "geckoId": null,
   "mcapTvl": 0.188,
   "mcapUsd": 3200000000,
   "twitter": "aave",
   "category": "Lending",
   "listedAt": "2022-04-01",
   "pool2Usd": null,
   "chainTvls": [
    {
     "chain": "Ethereum",
     "tvlUsd": 12000000000
    }
   ],
   "auditLinks": [
    "https://aave.com/security"
   ],
   "chainCount": 21,
   "stakingUsd": null,
   "borrowedUsd": 9000000000,
   "change1dPct": 0.8,
   "change1hPct": 0.02,
   "change7dPct": 2.4,
   "description": "Earn interest, borrow assets, and build applications",
   "parentProtocol": "aave"
  },
  "fetchedAt": "2026-08-22T12:00:00.000Z"
 }
}
```

## More

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