# Protocol TVL (Live Single Number)

> Protocol TVL (Live Single Number) is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns the current total value locked (TVL) for up to 20 named DeFi protocols as a single number each, using DefiLlama slugs.

## Facts

- Endpoint: GET https://x402.shizu.me/llama/tvl
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/protocol-tvl-live-single-number-f49d33dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_341B3XSt7VDULE89PS4Y1

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-live-single-number-f49d33dc
```

Example prompt: What's the current TVL for aave, uniswap-v3, and curve right now — just the live numbers, not the full history?

## When to prefer this

Use this endpoint when you need the current TVL for one or more DeFi protocols as a lightweight single-number lookup. Prefer this over a full protocol history endpoint when you only need the latest value and want to avoid fetching large historical blobs. Ideal for dashboards, alerts, or comparisons across up to 20 protocols in a single cheap call.

## Known failure modes

- Unknown or misspelled protocol slug returns null for that entry
- More than 20 slugs in the query may be rejected or truncated
- Payment of $0.003 USDC required per call; unpaid requests return 402
- Temporary DefiLlama data unavailability may yield stale or missing values

## How this service works

Current total TVL for named protocols, one number each — the cheap poll (avoids the 10MB per-protocol history blob). Query: protocol — comma list of DefiLlama slugs (up to 20), e.g. aave,uniswap-v3. null means an unknown slug.

## Output

Returns a JSON object mapping each requested protocol slug to its current TVL as a single USD number. Unknown or invalid slugs return null. Up to 20 protocols can be queried per call.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "protocol": {
       "type": "string"
      }
     },
     "required": [
      "protocol"
     ]
    }
   },
   "required": [
    "method"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "defillama",
  "tvl_usd": {
   "aave": 14400000000,
   "uniswap": 3100000000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/protocol-tvl-live-single-number-f49d33dc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)