# Vaults.fyi Portfolio Transaction History

> Vaults.fyi Portfolio Transaction History 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-10).

Retrieves all deposit and withdrawal transactions for a user's position in a specific vault on a given blockchain network.

## Facts

- Endpoint: HEAD https://api.vaults.fyi/v2/portfolio/events/:userAddress/:network/:vaultId?utm_source=zero.xyz
- Price: $0.006/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-portfolio-transaction-history-cc750682
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Nlaa95zHV-m_hqK8NgJ09

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-transaction-history-cc750682 -d '<json body>'
```

Example prompt: Show me all the deposits and withdrawals I've made to vault 0xabc123 on Ethereum for my wallet 0xdef456 — I want the full transaction history.

## When to prefer this

Use this endpoint when you need a complete chronological record of a user's deposit and withdrawal activity within a specific vault on a known blockchain network. It is ideal for portfolio reconciliation, auditing, tax reporting, or monitoring position changes over time. Prefer this over the total returns endpoint when you need individual transaction-level detail rather than aggregate performance metrics.

## Known failure modes

- Invalid or malformed userAddress returns 400 error
- Unsupported or unrecognized network identifier returns 404 or validation error
- Unknown vaultId returns empty result set or 404
- No transactions found for the address/vault combination returns empty array
- Network connectivity issues or API downtime return 5xx errors
- Insufficient payment (x402 protocol) results in 402 Payment Required

## How this service works

Retrieves all transactions (deposits and withdrawals) for a user's position in a specific vault, including transaction details and metadata.

## Output

Returns a list of transaction events (deposits and withdrawals) associated with the specified user's position in the given vault on the specified network, including transaction details such as amounts, timestamps, transaction hashes, and other relevant metadata.

## More

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