# BlockRun.AI DeFiLlama Protocol TVL Detail

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

Returns detailed Total Value Locked (TVL) figures and breakdowns for a single DeFi protocol by slug (e.g. aave-v4).

## Facts

- Endpoint: GET https://blockrun.ai/api/v1/defillama/protocol/aave-v4
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-defillama-protocol-tvl-detail-138d45f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cyuzF934TQG_A0mLoW3AQ

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-detail-138d45f0
```

Example prompt: Pull up the full TVL breakdown for Aave v4 — I want to see how the liquidity is distributed across chains.

## When to prefer this

Use this endpoint when you need granular, per-chain TVL breakdown for a single DeFi protocol by its DeFiLlama slug. Prefer this over generic search endpoints when you already know the protocol slug. It is ideal for protocol research, DeFi monitoring dashboards, and on-chain liquidity analysis. Use sibling endpoints for batch ranking or project search when the slug is unknown.

## Known failure modes

- Invalid or unknown protocol slug returns an error or empty response
- Protocol slug not found on DeFiLlama returns 404 or null data
- Rate limiting or payment failure results in 402 or 429 response
- Network timeout if DeFiLlama upstream is slow or unavailable
- Stale data if DeFiLlama hasn't recently indexed the protocol

## 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 JSON object containing the protocol's total TVL, a historical TVL series, per-chain TVL breakdown, token-level breakdown, protocol metadata (name, category, description, logo), and other DeFiLlama-sourced metrics 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-detail-138d45f0/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)