# BlockRun.AI DeFiLlama Protocol TVL Lookup

> BlockRun.AI DeFiLlama Protocol TVL Lookup is a paid API for AI agents from blockrun.ai, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Fetches detailed Total Value Locked (TVL) data and breakdown for a single DeFi protocol by its slug identifier.

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/defillama/protocol/rhea-finance
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-defillama-protocol-tvl-lookup-69842d47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rcA74o-DzweuYwNvxFUUD

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 blockrun-ai-defillama-protocol-tvl-lookup-69842d47
```

Example prompt: Pull the full TVL breakdown for Aave from DeFiLlama, including how it's distributed across chains.

## When to prefer this

Use this endpoint when you need granular, per-chain TVL breakdown for a specific DeFi protocol by its DeFiLlama slug. It is ideal for protocol research, portfolio monitoring, or competitive analysis where DeFiLlama is the authoritative source. Prefer this over broader market data APIs when the user needs DeFi-specific TVL metrics rather than price data.

## Known failure modes

- Invalid or misspelled protocol slug returns an error or empty response
- Protocol exists on DeFiLlama but slug format differs from expected (e.g., hyphenated vs non-hyphenated)
- DeFiLlama upstream data unavailability causes stale or missing TVL data
- Rate limiting or payment failure for the $0.006 USDC per-call fee
- Protocol with very low TVL or newly listed may have incomplete breakdown data

## How this service works

Detailed TVL + breakdown for a single protocol. Pass slug as `/v1/defillama/protocol/{slug}` (e.g. `aave`, `uniswap`).

## Output

Returns a detailed JSON object containing the protocol's total TVL, per-chain TVL breakdown, token-level breakdown, historical TVL figures, and other metadata sourced from DeFiLlama for the specified protocol slug.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "query": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-defillama-protocol-tvl-lookup-69842d47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)