# Citiview DeFi TVL Lookup

> Citiview DeFi TVL Lookup is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-14).

Returns total value locked (TVL) for a DeFi protocol and/or blockchain chain, along with the chain's TVL rank.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/defi/tvl?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-defi-tvl-lookup-8e1fca0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WN3onXYHMCyVloM0k7sbJ

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 citiview-defi-tvl-lookup-8e1fca0e
```

Example prompt: What's the current total value locked for Aave on Ethereum, and where does Ethereum rank by TVL?

## When to prefer this

Use this endpoint when you need real-time TVL data for a specific DeFi protocol or blockchain chain, including TVL rankings. Prefer it over general web search when you need structured, numeric TVL data that can be used programmatically. Best for DeFi research, portfolio analysis, or chain comparison workflows.

## Known failure modes

- Unknown protocol slug returns an error or empty result — use exact DefiLlama slugs (e.g. 'aave', 'uniswap-v3')
- Unknown chain name returns an error — use canonical names (e.g. 'base', 'ethereum', 'solana')
- Neither protocol nor chain provided may return an error or default data
- Stale data if DefiLlama upstream is delayed
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Total value locked for a DeFi protocol (aave, uniswap, aerodrome, lido...) and/or a chain (Base, Ethereum, Solana...), with the chain's TVL rank.

## Output

Returns the total value locked (TVL) in USD for the specified DeFi protocol and/or blockchain chain, along with the chain's TVL rank relative to other chains. Data is sourced from DefiLlama.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "description": "e.g. base"
      },
      "protocol": {
       "type": "string",
       "description": "DefiLlama slug, e.g. aave"
      }
     }
    }
   },
   "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/citiview-defi-tvl-lookup-8e1fca0e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)