# vaults.fyi Transaction Context

> vaults.fyi Transaction Context 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 the complete transactional context for a user's interaction with a specific vault, including deposit/redeem steps, current balances, and claimable rewards.

## Facts

- Endpoint: GET https://api.vaults.fyi/v2/transactions/context/:userAddress/: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-transaction-context-dad9dad3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rQ5-COc4Vl2IRU9n23Tns

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-transaction-context-dad9dad3
```

Example prompt: Can you pull up the full transaction context for my wallet 0xAbC123...456 on the Ethereum network for vault 0xVault789...def — I want to see what deposit and redeem steps are available, my current balance, and any rewards I can claim?

## When to prefer this

Use this endpoint when you need a complete, action-ready snapshot of a user's relationship with a specific vault — including what transactions they can execute right now, their live balance, and pending rewards. Prefer this over static vault list endpoints when you need user-specific, actionable context rather than general vault performance metrics.

## Known failure modes

- Invalid or unsupported vaultId returns a 404 or empty context
- Unsupported network identifier returns an error
- Malformed userAddress (non-checksummed or incorrect length) causes a validation error
- Vault with no user position returns empty balance and no available steps
- Network congestion or RPC timeouts may cause delayed or failed responses

## How this service works

Retrieves the complete transactional context for a user's interaction with a specific vault, including available deposit/redeem steps, current balances, and claimable rewards.

## Output

Returns a structured object containing available deposit and redeem transaction steps, the user's current vault balance, and any claimable reward amounts, all scoped to the specified wallet address, blockchain network, and vault ID.

## More

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