{"uid":"cap_lMGKC-OMq9qaJZhJ7-GP8","slug":"yield-xyz-get-wallet-yield-balances-d8cbfc8d","name":"Yield.xyz Get Wallet Yield Balances","description":"Get current yield balances and pending actions for a wallet address. Returns active positions, accrued rewards, and pending exits across one or more yields. Call this before actions_exit or actions_manage.","url":"https://mcp.stg.yield.xyz/x402/yields_get_balances?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"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":{"p10Cents":"0.1000","medianCents":"0.1000","p90Cents":"0.1000","minCents":"0.1000","maxCents":"0.1000","p95Cents":"0.1000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_tdIZqaBjEo_OFMr4Od9og","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":"Show me all my current yield positions, accrued rewards, and any pending exits for my wallet 0xAbC123...def456 — I want to see everything before I decide whether to exit.","exampleUseCases":[{"title":"Monitor staking rewards across protocols","prompt":"Check all my active staking positions and see how much I've earned so far across Lido, Aave, and any other protocols I'm in — I want to know my total accrued rewards before the end of the month."},{"title":"Review pending exits before confirming","prompt":"Pull up all my yield positions and show me which ones have pending withdrawal requests and how long until they settle — I need to see what's currently in exit status for wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f42e0A."},{"title":"Assess vault APY and current earnings","prompt":"Give me a snapshot of all my vault and lending positions right now, including the current APY on each one and the USD value of rewards I've accumulated — I'm thinking about reallocating and need the full picture."}],"resultDescription":"Returns a structured response containing active yield positions, accrued reward amounts, and pending exit requests associated with the given wallet address across all queried yield protocols. Useful as a prerequisite step before calling exit or manage actions.","failureModes":["Invalid or malformed wallet address returns a 400 error","Wallet address with no yield positions returns empty arrays","Network or protocol unavailability causes 503 or timeout","Insufficient payment (x402) results in payment-required error","Unknown yield ID returns an error or empty result for that position"],"whenToPreferThis":"Use this endpoint when you need to read the current state of a wallet's yield positions before taking action (exiting or managing). It is a prerequisite for actions_exit and actions_manage. Prefer this over on-chain direct queries when you want an aggregated, formatted view across multiple yield protocols in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T00:36:49.769Z","isFirstParty":false,"canonicalSlug":"yield-xyz-get-wallet-yield-balances-d8cbfc8d"}