{"uid":"cap_1WVGroO6qjsWpNfM348RU","slug":"beefy-finance-vault-positions-by-wallet-cabd0223","name":"Beefy Finance Vault Positions by Wallet","description":"All Beefy Finance vault positions of a wallet on Base, Ethereum, Arbitrum, Optimism or Polygon, read on-chain (shares and price per share) and valued in USD, including retired vaults where funds are often forgotten.","url":"https://api.vextorium.com/beefy-posiciones-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["direccion"],"properties":{"red":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"Chain: base (default), ethereum, arbitrum, optimism or polygon"},"direccion":{"type":"string","description":"EVM wallet address (0x...)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"red":{"type":["string","null"]},"nota":{"type":["string","null"]},"fuente":{"type":["string","null"]},"direccion":{"type":["string","null"]},"posiciones":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"id":{"type":["string","null"]},"url":{"type":["string","null"]},"estado":{"type":["string","null"]},"nombre":{"type":["string","null"]},"activos":{"type":["array","null"],"items":{"type":["null","string"]}},"apy_pct":{"type":["number","null"]},"cantidad":{"type":["number","null"]},"valor_usd":{"type":["number","null"]},"token_depositado":{"type":["string","null"]}}}},"valor_total_usd":{"type":["number","null"]},"vaults_revisados":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"red":"base","nota":"Incluye vaults retirados, donde a veces quedan fondos olvidados. No incluye BIFI en staking ni vaults de liquidez concentrada (CLM).","fuente":"Beefy (api.beefy.finance); participaciones y valor por participación leídos on-chain","direccion":"0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB","posiciones":[{"id":"aero-cow-weth-moobifi-vault","url":"https://app.beefy.com/vault/aero-cow-weth-moobifi-vault","estado":"activo","nombre":"WETH-mooBIFI","activos":["WETH","mooBIFI"],"apy_pct":35.35,"cantidad":9.436634596504046,"valor_usd":358.66,"token_depositado":"WETH-mooBIFI"}],"valor_total_usd":358.66,"vaults_revisados":533}},"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_F8_5dgF0i-a7yKlj1KLLx","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 Beefy Finance vault positions (active and retired) for an EVM wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, with share amounts, price-per-share, and USD valuations read directly on-chain.","exampleAgentPrompt":"What are all my Beefy Finance vault positions on Arbitrum for wallet 0xAbc123...? Include retired vaults and show me the USD value of each position.","exampleUseCases":[{"title":"Recover forgotten funds in retired vaults","prompt":"Check wallet 0xDead...Beef on Ethereum for any Beefy Finance vault positions, including retired or old vaults where I might have forgotten funds — show me the USD value of everything."},{"title":"DeFi portfolio audit across chains","prompt":"Give me a full breakdown of all Beefy Finance vault positions for my wallet 0x1234...5678 on Polygon, including the APY and current USD value of each position."},{"title":"Automated yield farming tracker","prompt":"Fetch all active and retired Beefy Finance vault positions for address 0xAbCd...EfGh on Base and tell me the total USD value of my portfolio there."}],"resultDescription":"Returns a structured object containing the wallet address, chain, total USD value across all vaults, number of vaults checked, and an array of individual vault positions each with vault ID, name, status (active/retired), deposited token, underlying assets, current quantity (in shares or deposit token units), APY percentage, USD value, and a URL to the vault. Also includes a source note and optional annotations.","failureModes":["Invalid or malformed wallet address returns an error or empty positions array","Unsupported chain value causes validation rejection","On-chain RPC errors may result in incomplete or null vault data","Wallet with no Beefy positions returns empty posiciones array with zero total_usd","Network congestion may cause slow or failed on-chain reads"],"whenToPreferThis":"Use this endpoint when you need to enumerate and value all Beefy Finance vault positions for a specific EVM wallet, especially when you want to surface forgotten funds in retired vaults that other portfolio trackers miss. Prefer this over generic DeFi portfolio APIs when the user specifically cares about Beefy Finance vaults and needs direct on-chain reads rather than indexed data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:40:53.269Z","isFirstParty":false,"canonicalSlug":"beefy-finance-vault-positions-by-wallet-cabd0223"}