# DeFi Protocol TVL Lookup

> DeFi Protocol TVL Lookup is a paid API for AI agents from defi.x402utils.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns the current total value locked (TVL) in USD for one or more specified DeFi protocols, paid per call via x402 micropayments.

## Facts

- Endpoint: GET https://defi.x402utils.workers.dev/v1/protocol-tvl?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-protocol-tvl-lookup-4d2abe4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w52CLF3DpCfbjwAiPviX_

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-4d2abe4b
```

Example prompt: What's the current total value locked for Aave and Uniswap right now?

## When to prefer this

Choose this endpoint when you need real-time TVL data for specific DeFi protocols by slug and want a low-cost, pay-per-call model via x402 micropayments on Base. It is ideal for agents that need to programmatically compare protocol sizes, monitor DeFi health, or enrich reports with live TVL figures without committing to a subscription.

## Known failure modes

- Unknown or misspelled protocol slug returns empty or error response
- Multiple protocol slugs with one invalid may cause partial or full failure
- Network or worker timeout if queried under load
- x402 payment failure if USDC balance on Base is insufficient
- Rate limiting if called too frequently without valid payment

## How this service works

DeFi total value locked for agents: TVL of any protocol and TVL ranking of chains. Paid per call via x402 (USDC on Base).

## Output

A JSON object keyed by protocol slug, each containing the protocol's current total value locked in USD (e.g. {"protocols":{"aave":{"tvl_usd":19222272263}}}).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "protocol"
     ],
     "properties": {
      "protocol": {
       "type": "string",
       "description": "comma-separated protocol slugs"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "protocols": {
   "aave": {
    "tvl_usd": 19222272263
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-protocol-tvl-lookup-4d2abe4b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi.x402utils.workers.dev](https://www.zero.xyz/host/defi.x402utils.workers.dev/llms.txt)