# DeFi Protocol TVL Lookup

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

Returns total value locked (USD) for a single DeFi protocol by DefiLlama slug or name, including per-chain TVL breakdown and 1h/1d/7d changes

## Facts

- Endpoint: POST https://crypto.openverbs.com/v1/protocol
- 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-1d428b0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F6Yf5YlYIthHv6L9dD7D-

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-1d428b0e -d '<json body>'
```

Example prompt: What's the current TVL for Aave v3, and how has it changed over the past 7 days? Also break it down by chain if you can.

## When to prefer this

Use this endpoint when you need detailed TVL data for a specific DeFi protocol — including per-chain breakdowns and recent TVL momentum (1h/1d/7d change). Prefer this over the ranked list endpoint when you already know the protocol name and need precise, single-protocol data. Ideal for monitoring TVL changes for a known protocol, or enriching research on a specific DeFi project with on-chain capital data.

## Known failure modes

- Unknown protocol name returns found:false with slug suggestions instead of TVL data
- Misspelled or ambiguous protocol names may return suggestions rather than exact matches
- Chain parameter not matching an active chain for the protocol may return null or missing chain TVL
- DefiLlama data may have brief delays for very recent TVL changes
- Rate limiting or payment failures may prevent successful API calls

## How this service works

Total value locked (USD) for one DeFi protocol by DefiLlama slug or name (e.g. "aave-v3", "lido", "uniswap-v3"): current TVL, per-chain TVL breakdown, 1h/1d/7d TVL change, category, chains, token symbol and market cap. Optional `chain` also returns that chain's TVL for the protocol. Unknown names return `found:false` with slug `suggestions`.

## Output

Returns a JSON object containing the protocol's current total TVL in USD, a per-chain TVL breakdown, percentage changes over 1h/1d/7d periods, the protocol's category (e.g. DEX, Lending), list of chains it operates on, associated token symbol, and market cap. If an optional chain is provided, also returns that chain's specific TVL for the protocol. If the protocol name is unknown, returns found:false along with slug suggestions.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "protocol"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "maxLength": 50,
       "minLength": 1,
       "description": "Optional chain to also report the protocol's TVL on, e.g. \"Ethereum\", \"Base\", \"Arbitrum\"."
      },
      "protocol": {
       "type": "string",
       "maxLength": 80,
       "minLength": 1,
       "description": "DefiLlama protocol slug or exact name, e.g. \"aave-v3\", \"lido\", \"uniswap-v3\", \"Curve Finance\"."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-protocol-tvl-lookup-1d428b0e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.openverbs.com](https://www.zero.xyz/host/crypto.openverbs.com/llms.txt)