{"uid":"cap_-msJXWi-jNzuEOenLHLK9","slug":"mcp-yield-xyz-get-yield-balances-8b850267","name":"mcp.yield.xyz – Get Yield Balances","description":"Get live DeFi yield balances and pending actions for any wallet — active staking, lending, vault, and RWA positions with accrued rewards, USD values, current APY, and claimable actions. Covers 3,300+ yields (Lido, Aave, Morpho, tokenized treasuries) across 80+ networks. Call before actions_exit or actions_manage.","url":"https://mcp.yield.xyz/x402/yields_get_balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"Wallet address to query (EVM 0x…, Solana base58, or Cosmos bech32)"},"network":{"type":"string","description":"Network slug, e.g. \"ethereum\", \"base\", \"arbitrum\", \"solana\""},"yieldIds":{"type":"array","items":{"type":"string"},"description":"Optional: limit the lookup to specific yield IDs, e.g. [\"base-usdc-aave-v3-lending\"]. Omit to scan all yields on the network."}}},"responseSchema":{"type":"json","example":{"items":[{"yieldId":"base-usdc-dinari-usd-plus-vault","balances":[{"type":"active","token":{"name":"USD Coin","symbol":"USDC","network":"base","decimals":6},"amount":"0.300521","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","amountUsd":"0.300435","isEarning":true,"pendingActions":[{"type":"UNSTAKE","intent":"manage","passthrough":"eyJhZGRy…"}]}]}],"errors":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f4WL5nT7U-poFfoeLf_i5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current yield positions, accrued rewards, and pending exits for a wallet address across one or more yield protocols.","exampleAgentPrompt":"What are my current yield balances, accrued rewards, and any pending exits for wallet 0xABC123... on the Ethereum network?","exampleUseCases":[{"title":"Check staking rewards before unstaking","prompt":"Before I unstake, can you pull up all my accrued rewards and current staking balances for wallet 0xDEF456... on Ethereum? I want to see exactly what I've earned across Lido and Aave before I do anything."},{"title":"Portfolio snapshot across DeFi positions","prompt":"Give me a full breakdown of every active yield position for wallet 0x7890AB... — I want to see the USD values, current APYs, and any claimable rewards across all protocols on Base right now."},{"title":"Review pending exits for wallet","prompt":"Can you check if there are any pending exits or locked positions for wallet 0x1234CD... on Ethereum? I'm trying to figure out what's still in-flight before I decide my next move."}],"resultDescription":"Returns a structured object containing active yield positions, accrued reward amounts, and pending exit statuses for the specified wallet address across the requested yield IDs on the given network.","failureModes":["Invalid or malformed wallet address returns a validation error","Unsupported network slug returns an error indicating the network is not recognized","Unknown yieldIds return empty or null entries for those IDs","Network timeout or upstream RPC failure may return a 5xx error","Wallet with no positions returns an empty balances array"],"whenToPreferThis":"Use this endpoint before calling actions_exit or actions_manage — it provides the current state of a wallet's yield positions necessary to construct exit or management transactions. Prefer this over generic blockchain explorers when you need yield-specific balance data including rewards and pending actions in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:40:50.902Z","isFirstParty":false}