# DeFi Protocol TVL Lookup via DeFiLlama

> DeFi Protocol TVL Lookup via DeFiLlama is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the current Total Value Locked (TVL) for a DeFi protocol by its DeFiLlama slug, including per-chain breakdown and 24h/7d/30d change metrics.

## Facts

- Endpoint: POST https://agent402.tools/api/defi-tvl
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-lookup-via-defillama-b15b4ad4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sam4txpu6ygjaPpiEAOoB

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-protocol-tvl-lookup-via-defillama-b15b4ad4 -d '<json body>'
```

Example prompt: What's the current TVL for Lido across all chains, and how has it changed over the past 7 days?

## When to prefer this

Use this endpoint when you need current TVL data for a specific DeFi protocol by its DeFiLlama slug, especially when you want per-chain breakdowns and recent trend data. Prefer this over general financial data APIs when the protocol is indexed by DeFiLlama and you need DeFi-specific liquidity metrics rather than price or volume data.

## Known failure modes

- Unknown or misspelled protocol slug returns an error or empty result
- Protocol not indexed by DeFiLlama returns no data
- API rate limiting or upstream DeFiLlama outage causes timeout
- Missing required 'protocol' field in request body causes validation error

## How this service works

Look up the current Total Value Locked (TVL) for a DeFi protocol via DeFiLlama's public API. Identify the protocol by its DeFiLlama slug (uniswap, aave, lido, ethena, etc.). Returns the total TVL plus per-chain breakdown and 24h/7d/30d change where DeFiLlama exposes it.

## Output

Returns the total TVL in USD for the specified DeFi protocol, a breakdown of TVL per blockchain (e.g. Ethereum, Arbitrum, Polygon), and percentage or absolute changes over 24h, 7d, and 30d periods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "protocol": {
   "type": "string",
   "description": "DeFiLlama protocol slug (e.g. uniswap, aave, lido). Lowercase, hyphen-separated."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "AAVE",
  "tvlUsd": 15000000000,
  "category": "Lending",
  "change7d": 2.1,
  "protocol": "aave",
  "chainTvls": [
   {
    "chain": "Ethereum",
    "tvlUsd": 11000000000
   }
  ],
  "change24h": 0.5,
  "change30d": 8
 }
}
```

## More

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