{"uid":"cap_rQ5-COc4Vl2IRU9n23Tns","slug":"vaults-fyi-transaction-context-dad9dad3","name":"vaults.fyi Transaction Context","description":"Retrieves the complete transactional context for a user's interaction with a specific vault, including available deposit/redeem steps, current balances, and claimable rewards.","url":"https://api.vaults.fyi/v2/transactions/context/:userAddress/:network/:vaultId?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GbwAD_xnbcYC2qRPpec0B","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the complete transactional context for a user's interaction with a specific vault, including deposit/redeem steps, current balances, and claimable rewards.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Claiming rewards from a yield vault","prompt":"Check my wallet 0xAbC123...456 on the Arbitrum network for vault 0xVault789...def and tell me if I have any claimable rewards and how to claim them."},{"title":"Preparing a vault deposit for a user","prompt":"My wallet is 0xDeFi456...789 and I want to deposit into vault 0xV123...abc on the Optimism network — what are the exact steps I need to follow to complete the deposit?"},{"title":"Checking available redemption options","prompt":"Look up the transaction context for wallet 0xUser321...654 on the Base network for vault 0xRedeem...111 — I need to know if I can redeem my position and what steps are involved."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:49:20.007Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-transaction-context-dad9dad3"}