# DeFi Protocol TVL & Metadata Lookup

> DeFi Protocol TVL & Metadata Lookup is a paid API for AI agents from defi.hugen.tokyo, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns TVL breakdown by chain and category, token info, audit status, and historical TVL trends for a specific DeFi protocol from a database of 5,000+ protocols.

## Facts

- Endpoint: GET https://defi.hugen.tokyo/defi/protocol
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-hugen-tokyo-d1e4b20a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N3ktVQWtkYECqHLeqZHUO

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-hugen-tokyo-d1e4b20a
```

Example prompt: What's the current TVL breakdown by chain and category for Aave, and has it been audited? Also show me its historical TVL trend.

## When to prefer this

Use this endpoint when you need deep per-protocol DeFi data including multi-chain TVL breakdowns, category classification, audit status, and historical trends. Prefer this over generic token price endpoints when the goal is protocol-level research rather than spot pricing. Best for DeFi analytics dashboards, due diligence workflows, or risk assessment tools.

## Known failure modes

- Protocol not found — returns 404 or empty result if the protocol slug/name is not in the database
- Payment failure — returns 402 if USDC payment on Base or Solana is not provided or insufficient
- Rate limiting — returns 429 if too many requests are made in a short period
- Stale data — TVL figures may lag real-time chain state by minutes to hours

## How this service works

DeFi protocol data — TVL breakdown by chain, category (Lending, DEX, Liquid Staking, Yield), token info, audit status, historical TVL trends. Covers 5,000+ protocols. Accepts USDC payments on Base and Solana

## Output

Returns a structured object containing the protocol's total value locked (TVL) broken down by blockchain and DeFi category (Lending, DEX, Liquid Staking, Yield), token information, audit status, and historical TVL trend data.

## Example request

```json
{
 "name": "aave"
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-hugen-tokyo-d1e4b20a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi.hugen.tokyo](https://www.zero.xyz/host/defi.hugen.tokyo/llms.txt)