# Vaults.fyi TVL Breakdown

> Vaults.fyi TVL Breakdown is a paid API for AI agents from api.vaults.fyi, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Retrieves a detailed breakdown of Total Value Locked (TVL) for a specific DeFi vault on a given blockchain network.

## Facts

- Endpoint: HEAD https://api.vaults.fyi/v2/detailed-vaults/:network/:vaultId/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/vaults-fyi-tvl-breakdown-7ab9a985
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_prfOhTuufaF4ZIenKC1w4

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 vaults-fyi-tvl-breakdown-7ab9a985 -d '<json body>'
```

Example prompt: Can you pull up the TVL breakdown for vault 0xabc123 on the Ethereum network from Vaults.fyi so I can see how the total locked value is distributed?

## When to prefer this

Use this endpoint when you need a granular, component-level breakdown of TVL for a specific vault — not just the aggregate TVL figure. Prefer this over the general vault list endpoint when you already know the vault ID and network and need TVL composition detail specifically, or when building dashboards that track TVL distribution over time.

## Known failure modes

- Invalid or unsupported network identifier returns 404 or error
- Non-existent vault ID returns 404 not found
- Network or vault combination not supported returns error
- Rate limiting or payment failure returns 402 or 429
- Vault with no TVL data returns empty or null breakdown

## How this service works

Retrieves vault Tvl breakdown.

## Output

Returns a structured breakdown of Total Value Locked (TVL) for the specified vault, decomposed into its constituent components (e.g. by asset, depositor category, or yield source) for the given network and vault ID.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-tvl-breakdown-7ab9a985/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vaults.fyi](https://www.zero.xyz/host/api.vaults.fyi/llms.txt)