# crypto.openverbs.com TVL Lookup

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

Returns the current total value locked (USD) for a specific DeFi protocol (e.g. Aave) or an entire blockchain (e.g. Ethereum)

## Facts

- Endpoint: POST https://crypto.openverbs.com/v1/tvl
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-openverbs-com-tvl-lookup-f78b76a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2z4GfFMAxF0qEgFPNtnWa

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 crypto-openverbs-com-tvl-lookup-f78b76a8 -d '<json body>'
```

Example prompt: What's the current total value locked for Aave? I want the USD TVL figure right now.

## When to prefer this

Use this endpoint when you need TVL for a single specific protocol or chain by name. Prefer it over the DeFi market overview endpoint when you want targeted data for one entity rather than a global summary. Ideal for due diligence, protocol comparison, or monitoring a specific protocol's health over time.

## Known failure modes

- Unknown protocol slug returns an error or zero TVL — use exact DeFiLlama slugs like 'aave' not 'AAVE'
- Providing both protocol and chain simultaneously is rejected — only one is allowed
- Unrecognized chain name returns an error — use canonical names like 'Ethereum' not 'ETH'
- Network timeouts if upstream DeFiLlama data source is slow or unavailable
- Payment failure if x402 micropayment of $0.001 USDC is not included

## How this service works

Total value locked (USD) for a DeFi protocol (e.g. "aave") or a whole chain (e.g. "Ethereum"). Provide exactly one of `protocol` or `chain`.

## Output

A USD total value locked figure for the requested protocol slug (e.g. 'aave', 'uniswap') or chain name (e.g. 'Ethereum', 'Solana'), returned as a numeric value representing current on-chain deposits.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "protocol": {
       "type": "string",
       "minLength": 1,
       "maxLength": 100,
       "description": "Protocol slug, e.g. \"aave\", \"uniswap\", \"lido\"."
      },
      "chain": {
       "type": "string",
       "minLength": 1,
       "maxLength": 100,
       "description": "Chain name, e.g. \"Ethereum\", \"Arbitrum\", \"Solana\"."
      }
     },
     "required": [],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "protocol",
  "name": "aave-v3",
  "found": true,
  "stale": false,
  "source": "defillama",
  "tvlUsd": 17459433934.27
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-openverbs-com-tvl-lookup-f78b76a8/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)