# Vaults.fyi Portfolio Positions

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

Returns all DeFi vault positions held by a specific wallet address, with optional filters.

## Facts

- Endpoint: GET https://api.vaults.fyi/v2/portfolio/positions/:userAddress?utm_source=zero.xyz
- Price: $0.01/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-portfolio-positions-ced553a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hF2LpXha2miQgpy7TgwRp

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-portfolio-positions-ced553a4
```

Example prompt: Show me all the vault positions my wallet 0xAbC...1234 is currently in on vaults.fyi, including any filters for active positions only.

## When to prefer this

Use this endpoint when you need a comprehensive list of all vault positions for a specific wallet address across supported networks. Prefer this over the single-position endpoint when you don't know which specific vault to query, or when you need a full portfolio overview. Use the best-opportunity endpoint instead if you want a recommendation rather than current holdings.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet address with no vault positions returns an empty array
- Network timeout or downstream data unavailability returns a 5xx error
- Unsupported filter parameters may be silently ignored or return 400

## How this service works

Provides all vault positions for the user, with optional filters.

## Output

Returns a list of vault position objects for the given wallet address, each containing vault name, network/chain, deposited asset details, token balances, current APY, and other position metadata. Supports optional filters to narrow results.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaults-fyi-portfolio-positions-ced553a4/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)