# agentsvc.io DeFi TVL Lookup

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

Fetches DeFi protocol TVL data, top protocols by chain/category, chain stats, and DEX volume from DefiLlama via a pay-per-call API.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/defi-tvl?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsvc-io-defi-tvl-lookup-ad8b07e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A3KoyhGZdnuQ7tdr41Rds

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 agentsvc-io-defi-tvl-lookup-ad8b07e4 -d '<json body>'
```

Example prompt: What's the current TVL for Aave across all chains, and how has it changed over the last 7 days? Use protocol mode and search for 'aave'.

## When to prefer this

Use this endpoint when you need real-time DeFi TVL data sourced from DefiLlama without needing a DefiLlama API key or account. It is ideal for agents that need on-demand TVL lookups paid per-call in USDC with no subscription overhead. Prefer this over direct DefiLlama API calls when operating in a pay-per-use agent economy or when account management is undesirable.

## Known failure modes

- Protocol slug not found returns found:false with empty protocols array
- Invalid mode enum value returns a validation error
- Chain name typo may return no results
- Payment failure (402) if USDC balance is insufficient
- Rate limit or upstream DefiLlama API unavailability causes service errors

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

Returns a JSON object with the queried mode, a found flag, the source (DefiLlama), a timestamp, and an array of matched protocols each containing name, slug, symbol, TVL in USD, category, DefiLlama URL, top chains with TVL breakdown, chain count, mcap-to-TVL ratio, and 1-day and 7-day percentage changes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "protocol",
    "top",
    "chains",
    "dex_volume"
   ],
   "type": "string"
  },
  "chain": {
   "type": "string",
   "description": "Chain name, e.g. Base, Ethereum (modes top, dex_volume)"
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1
  },
  "category": {
   "type": "string",
   "description": "DefiLlama category (mode top)"
  },
  "protocol": {
   "type": "string",
   "description": "Protocol slug or name (mode protocol)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "mode": "protocol",
   "found": true,
   "query": "aave",
   "source": "DefiLlama",
   "protocols": [
    {
     "url": "https://aave.com",
     "name": "Aave V3",
     "slug": "aave-v3",
     "symbol": "AAVE",
     "tvl_usd": 18447878695,
     "category": "Lending",
     "mcap_usd": null,
     "defillama": "https://defillama.com/protocol/aave-v3",
     "top_chains": [
      {
       "chain": "Ethereum",
       "tvl_usd": 15545458426
      },
      {
       "chain": "Base",
       "tvl_usd": 574387153
      }
     ],
     "chain_count": 21,
     "mcap_to_tvl": null,
     "change_1d_pct": -0.62,
     "change_7d_pct": 0.2
    },
    {
     "url": "https://aave.com",
     "name": "Aave V4",
     "slug": "aave-v4",
     "symbol": "AAVE",
     "tvl_usd": 675107580,
     "category": "Lending",
     "mcap_usd": null,
     "defillama": "https://defillama.com/protocol/aave-v4",
     "top_chains": [
      {
       "chain": "Ethereum",
       "tvl_usd": 461813271
      },
      {
       "chain": "Arc",
       "tvl_usd": 183375728
      }
     ],
     "chain_count": 3,
     "mcap_to_tvl": null,
     "change_1d_pct": -0.4,
     "change_7d_pct": 3.07
    }
   ],
   "checked_at": "2026-10-06T14:29:38.091Z"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsvc-io-defi-tvl-lookup-ad8b07e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)