# DeFi TVL Lookup (DefiLlama)

> DeFi TVL Lookup (DefiLlama) is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-20).

Returns total value locked (TVL) in USD for a specific DeFi protocol by slug, or lists the top 25 largest protocols by TVL if no protocol is specified.

## Facts

- Endpoint: GET https://api.gadgethumans.com/defi-tvl?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-tvl-lookup-defillama-b6fcd0ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rs9wC7MHWl6SOEFz1Zs5s

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-tvl-lookup-defillama-b6fcd0ae
```

Example prompt: What's the current total value locked for Aave? Pull its TVL, category, and supported chains from DefiLlama.

## When to prefer this

Use this endpoint when you need current TVL data for one or more DeFi protocols sourced from DefiLlama. Ideal for DeFi research, protocol comparison, or monitoring liquidity concentration. Prefer this over scraping DefiLlama directly since it provides a clean structured API response with per-call pricing and no authentication setup required.

## Known failure modes

- Invalid or misspelled protocol slug returns an error or empty result
- Protocol not indexed by DefiLlama returns no data
- Stale TVL data if DefiLlama source is temporarily delayed
- Network or payment authorization failure returns HTTP error

## How this service works

Total value locked in USD for any DeFi protocol slug (aave, lido, uniswap, eigenlayer...), plus chains, category and links. Call with no protocol to get the 25 largest protocols ranked by TVL. Source: DefiLlama.

## Output

Returns TVL in USD for the requested protocol along with the chains it operates on, its DeFi category (e.g. lending, DEX, liquid staking), and relevant links. If no protocol is specified, returns the top 25 protocols ranked by TVL with the same metadata for each.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "protocol"
     ],
     "properties": {
      "protocol": {
       "type": "string",
       "description": "DefiLlama protocol slug, e.g. aave; omit for the top 25"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "ok": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-tvl-lookup-defillama-b6fcd0ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gadgethumans.com](https://www.zero.xyz/host/api.gadgethumans.com/llms.txt)
