{"uid":"cap_6az-1z9RGTsdEGAWZUWAM","slug":"vaults-fyi-single-vault-position-detail-3f603d48","name":"vaults.fyi Single Vault Position Detail","description":"Gives a detailed view of one specific vault position on a given network.","url":"https://api.vaults.fyi/v2/portfolio/positions/:userAddress/:network/:vaultId?utm_source=zero.xyz","method":"HEAD","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I9l7I7GlMDchPHJVsIlMu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a detailed view of a specific user's position in a single vault on a given blockchain network.","exampleAgentPrompt":"Show me the detailed position for wallet 0xAbC123... in vault 0xVault456 on the Ethereum network using vaults.fyi.","exampleUseCases":[{"title":"DeFi portfolio position audit","prompt":"Pull up the full position details for my wallet 0xAbC123def456 in vault 0xVault789 on the Arbitrum network — I want to see exactly what I'm holding there."},{"title":"Yield farming position check","prompt":"Can you check my position in vault 0xYield001 on the Optimism network for wallet address 0xMyWallet999? I want to see a detailed breakdown of what I have in that vault."},{"title":"Multi-wallet position comparison","prompt":"Fetch the position details for wallet 0xFund123 in vault 0xStableVault on the Base network — I'm comparing holdings across different wallets."}],"resultDescription":"A detailed breakdown of the user's position in the specified vault on the given network, including position size, asset details, and vault-specific metrics for that wallet address.","failureModes":["Invalid or non-existent userAddress returns 404 or empty result","Unsupported network identifier causes a bad request error","Invalid vaultId returns not found or empty response","User has no position in the specified vault returns empty or zero position","Network congestion or provider downtime causes timeout or 503 error"],"whenToPreferThis":"Use this endpoint when you need detailed information about one specific vault position for a single user on a particular network. Prefer this over portfolio-wide endpoints when you only need to inspect a single vault, or when you have a specific vaultId and userAddress in hand and want depth rather than breadth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:41:41.126Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-single-vault-position-detail-3f603d48"}