{"uid":"cap_hF2LpXha2miQgpy7TgwRp","slug":"vaults-fyi-portfolio-positions-ced553a4","name":"Vaults.fyi Portfolio Positions","description":"Provides all vault positions for the user, with optional filters.","url":"https://api.vaults.fyi/v2/portfolio/positions/:userAddress?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q3D0T3Rgkn9_0gbcuekJ2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all DeFi vault positions held by a specific wallet address, with optional filters.","exampleAgentPrompt":"Show me all the vault positions my wallet 0xAbC...1234 is currently in on vaults.fyi, including any filters for active positions only.","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Pull up all the vault positions for my wallet 0xAbC...1234 — I want to see every vault I'm currently deposited in across all networks."},{"title":"Yield farming exposure audit","prompt":"Can you check all vault positions held by 0xDeF...5678 and tell me which vaults they're deposited in and how much?"},{"title":"Multi-chain vault holdings overview","prompt":"Give me a complete list of all my active vault positions across chains for wallet address 0x123...ABCD — I need to see where my funds are deployed right now."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:48.752Z","isFirstParty":false,"canonicalSlug":"vaults-fyi-portfolio-positions-ced553a4"}