# Vaults.fyi Detailed Vault Performance Metrics

> Vaults.fyi Detailed Vault Performance Metrics is a paid API for AI agents from api.vaults.fyi, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).

Retrieves comprehensive performance metrics for a single DeFi vault, including APY, TVL, rewards, risk scores, and protocol information for a specified network and vault ID.

## Facts

- Endpoint: HEAD https://api.vaults.fyi/v2/detailed-vaults/:network/:vaultId?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaults-fyi-detailed-vault-performance-metrics-037308fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_19COWJRwmC8n0UZG41byU

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-detailed-vault-performance-metrics-037308fd -d '<json body>'
```

Example prompt: Can you pull up the full performance metrics for the USDC vault on Ethereum from vaults.fyi — I want to see the current APY, TVL, reward breakdown, and risk score before I decide whether to deposit?

## When to prefer this

Use this endpoint when you need the full, detailed performance profile of a single known vault — including APY breakdown, TVL, rewards, and risk scores — rather than browsing a list of vaults. It's ideal when you already have a specific network and vault ID and want comprehensive due-diligence data before investing or monitoring a position. For discovering vaults across the ecosystem, use the list endpoint instead.

## Known failure modes

- Invalid or unsupported network identifier returns a 400 or 404 error
- Unknown vault ID for the given network returns a 404 not found response
- Rate limiting or quota exhaustion may return a 429 error
- Network or vault data temporarily unavailable may result in 503 or timeout
- Malformed filter parameters may cause a 400 bad request

## How this service works

Retrieves a detailed performance metrics of single vault including APY, TVL, rewards, risk scores, and protocol information based on specified filters.

## Output

Returns a structured JSON object containing detailed performance metrics for the specified vault, including current and historical APY figures, total value locked (TVL), reward token information, risk assessment scores, and underlying protocol metadata such as protocol name, chain, and contract addresses.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-detailed-vault-performance-metrics-037308fd/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)