# vaults.fyi Best Vault Recommendation

> vaults.fyi Best Vault Recommendation is a paid API for AI agents from api.vaults.fyi, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Returns the single best vault opportunity for a given user wallet address based on their balance and yield analysis.

## Facts

- Endpoint: HEAD https://api.vaults.fyi/v2/portfolio/best-vault/:userAddress?utm_source=zero.xyz
- Price: $0.004/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-best-vault-recommendation-3ed36667
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YifZ8U6Fn6fHq3vf458di

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-best-vault-recommendation-3ed36667 -d '<json body>'
```

Example prompt: What's the single best vault I should move my funds into right now for wallet 0xABC123...? I want to maximize yield based on my current balance.

## When to prefer this

Use this endpoint when you need a single, decisive vault recommendation for a specific user rather than browsing all vaults. Ideal for agents automating yield optimization or helping users quickly identify where to deploy capital without manually comparing multiple options.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet address with no supported assets or zero balance may return no recommendation
- Network outage or provider downtime returns 503
- Rate limiting or payment failure returns 402 or 429

## How this service works

Returns the single best vault opportunity for the user, based on balance and yield analysis.

## Output

Returns the single highest-opportunity vault for the specified user wallet, based on analysis of the user's balance across supported networks and current vault yields, including vault details such as APY, TVL, network, and asset information.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-best-vault-recommendation-3ed36667/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)