# Protocol TVL Lookup via DefiLlama

> Protocol TVL Lookup via DefiLlama is a paid API for AI agents from protocol-tvl.hergertsynthora.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns Total Value Locked (TVL) for any DeFi protocol, including per-chain breakdown and historical trend data sourced from DefiLlama.

## Facts

- Endpoint: POST https://protocol-tvl.hergertsynthora.com/service
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/protocol-tvl-lookup-via-defillama-e0191dc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wGLiYIr9kXNSu6kCmTFo7

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

Example prompt: What's the current TVL for Aave, broken down by chain, and how has it trended historically?

## When to prefer this

Use this endpoint when you need TVL data for a DeFi protocol, especially if you want per-chain breakdown or historical trend data. Prefer this over general web search when you need structured, numeric TVL figures from DefiLlama's aggregated data. Good for DeFi analytics, protocol comparison, and risk assessment workflows.

## Known failure modes

- Unknown or misspelled protocol name returns an error or empty result
- Upstream DefiLlama API failure returns no charge and an error response
- Missing or malformed X-WALLET header may prevent free-tier access
- Protocol not tracked by DefiLlama returns no data

## How this service works

Total Value Locked for any DeFi protocol, per-chain breakdown, historical trend via DefiLlama. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns the Total Value Locked for the specified DeFi protocol, including a per-chain breakdown showing how TVL is distributed across networks (e.g. Ethereum, Arbitrum, Polygon), plus historical TVL data points for trend analysis — all sourced from DefiLlama.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "description": "SYNTHORA protocol-tvl: tVL de un protocolo con su CUOTA sobre el TVL total y su puesto en el ranking: contexto que el dato suelto no da."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "protocol_tvl",
  "result": {
   "senal": "concentra el 3.6007% del TVL DeFi total y ocupa el puesto 4",
   "fuente": "<omitido en el ejemplo publico>",
   "tvl_usd": 17522595363.25279,
   "protocol": "lido",
   "as_of_utc": "2026-08-05T16:31:36Z",
   "latencia_s": 0.52,
   "puesto_por_tvl": 4,
   "tvl_total_defi_usd": 486638092376.1603,
   "cuota_sobre_tvl_total_pct": 3.6007
  }
 }
}
```

## More

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