# vaults.fyi Vault APY Breakdown

> vaults.fyi Vault APY 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-11).

Retrieves a detailed APY breakdown for a specific DeFi vault on a given blockchain network, showing the components contributing to total yield.

## Facts

- Endpoint: HEAD https://api.vaults.fyi/v2/detailed-vaults/:network/:vaultId/apy?utm_source=zero.xyz
- Price: $0.002/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-vault-apy-breakdown-51d4f05a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gtaDVxExO2jMPViPdV-Ri

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-vault-apy-breakdown-51d4f05a -d '<json body>'
```

Example prompt: Can you pull up the full APY breakdown for vault 0xabc123 on Ethereum mainnet — I want to see how much comes from base yield versus reward tokens?

## When to prefer this

Use this endpoint when you need granular APY composition data for a specific vault — not just the headline APY number. It is ideal for yield sustainability analysis, comparing base vs incentive yields, and making informed DeFi investment decisions. Prefer this over the general vault listing endpoint when you already know the network and vault ID and need deep yield detail rather than a summary view.

## Known failure modes

- Invalid or unsupported network identifier returns a 404 or error response
- Unknown vault ID for the specified network returns not found
- Network or vault ID mismatch causes empty or error result
- Vault may be deprecated or paused, returning zero APY or error
- Rate limiting may occur for high-frequency polling

## How this service works

Retrieves vault APY breakdown.

## Output

Returns a structured breakdown of the vault's APY, including total APY and its individual components such as base yield, protocol incentives, and token rewards. Each component typically includes its contribution rate and source, allowing users to assess the sustainability and composition of the vault's yield.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-vault-apy-breakdown-51d4f05a/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)