{"uid":"cap_aV30y_qgWJaqv0kcIpGp8","slug":"beefy-finance-vault-positions-lookup-93f0adc3","name":"Beefy Finance Vault Positions Lookup","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/beefy-positions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"EVM wallet address (0x...)"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"Chain: base (default), ethereum, arbitrum, optimism or polygon"}}},"responseSchema":{"type":"json","example":{"note":"Includes retired vaults, where forgotten funds sometimes remain. Does not include staked BIFI or concentrated liquidity vaults (CLM).","source":"Beefy (api.beefy.finance); shares and price per share read on-chain","address":"0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB","network":"base","positions":[{"id":"aero-cow-weth-moobifi-vault","url":"https://app.beefy.com/vault/aero-cow-weth-moobifi-vault","name":"WETH-mooBIFI","amount":9.436634596504046,"assets":["WETH","mooBIFI"],"status":"active","apy_pct":35.35,"value_usd":358.66,"deposited_token":"WETH-mooBIFI"}],"reviewed_vaults":533,"total_value_usd":358.66}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_02uSG407Xu6cnRDLuhGI8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all Beefy Finance yield vault positions (amount, value, APY) for a given EVM wallet address on a specified chain.","exampleAgentPrompt":"Can you check my Beefy Finance vault positions for wallet 0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB on Base — show me which vaults I'm in, how much they're worth in USD, and what APY I'm earning?","exampleUseCases":[{"title":"DeFi portfolio value check","prompt":"What's the total USD value of my Beefy Finance yield positions for address 0xAbC123...def456 on Arbitrum, and which vaults am I currently deposited in?"},{"title":"Recovering forgotten vault funds","prompt":"I think I left some funds in old Beefy vaults — can you scan wallet 0x1A07DceEfeEbBA3D1873e2B92BeF190d2f11C3cB on Ethereum including any retired vaults so I don't miss anything?"},{"title":"APY performance review","prompt":"Show me all my active Beefy Finance positions on Polygon for wallet 0xDeFi...5678 and list the APY I'm earning on each one so I can see which vaults are performing best."}],"resultDescription":"Returns a JSON object containing the wallet address, network, a list of vault positions (each with vault ID, name, URL, deposited token, asset pair, amount, USD value, APY percentage, and status), the number of reviewed vaults, and total portfolio value in USD. Includes retired vaults where funds may remain, but excludes staked BIFI and concentrated liquidity (CLM) vaults.","failureModes":["Invalid or malformed EVM address returns an error or empty positions array","Unsupported network enum value causes a validation error","Wallet with no Beefy positions returns an empty positions array with total_value_usd of 0","On-chain RPC timeouts may cause partial or failed responses","Beefy API downtime upstream may result in stale or unavailable data"],"whenToPreferThis":"Choose this endpoint when you need to look up Beefy Finance vault positions for a specific EVM wallet across Base, Ethereum, Arbitrum, Optimism, or Polygon. It is specifically useful for DeFi portfolio dashboards, yield farming audits, or recovering forgotten funds in retired vaults. It reads shares and price-per-share directly on-chain via Beefy's API, making it more reliable than parsing raw contract events. Prefer this over generic token balance endpoints when the user is specifically asking about Beefy yield vault positions and APY.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:50.290Z","isFirstParty":false,"canonicalSlug":"beefy-finance-vault-positions-lookup-93f0adc3"}