{"uid":"cap_1WR0Be-ExGqGiXrEkZJdB","slug":"yield-xyz-manage-pending-actions-claim-restake-unlock-withdraw-a3d0ab0a","name":"yield.xyz Manage Pending Actions (Claim, Restake, Unlock, Withdraw)","description":"Build unsigned transactions for pending actions on an existing DeFi position — claim rewards, restake, unlock, or complete a withdrawal — across 80+ networks. Use the action type and passthrough from yields_get_balances pendingActions[]. Does NOT execute: the caller signs and broadcasts each tx.","url":"https://mcp.yield.xyz/x402/actions_manage?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"action":{"type":"string","description":"Pending action type from yields_get_balances pendingActions[].type, e.g. \"CLAIM_REWARDS\", \"RESTAKE_REWARDS\", \"UNLOCK\", \"WITHDRAW\""},"amount":{"type":"string","description":"Human-readable token amount, when the action requires one"},"address":{"type":"string","description":"Wallet address that owns the position"},"yieldId":{"type":"string","description":"Yield ID of the position, e.g. \"ethereum-matic-native-staking\""},"passthrough":{"type":"string","description":"Opaque token from yields_get_balances pendingActions[].passthrough — pass it back verbatim"}}},"responseSchema":{"type":"json","example":{"id":"7a2b9c4d-1e5f-4a8b-9c3d-6e7f8a9b0c1d","type":"CLAIM_REWARDS","amount":null,"intent":"manage","status":"CREATED","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","yieldId":"ethereum-matic-native-staking","transactions":[{"id":"5e6f7a8b-9c0d-1e2f-3a4b-5c6d7e8f9a0b","type":"CLAIM_REWARDS","title":"CLAIM_REWARDS Transaction","status":"CREATED","network":"ethereum","stepIndex":0,"unsignedTransaction":"{\"from\":\"0xd8dA…\",\"to\":\"0x5e3e…\",\"data\":\"0x8f2e…\"}"}],"executionPattern":"synchronous"}},"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_-kA1y9XacFrSsArnumRwW","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":"Constructs unsigned blockchain transactions for pending yield actions such as claiming rewards, restaking, unlocking, or completing withdrawals — caller must sign and submit.","exampleAgentPrompt":"Build me an unsigned transaction to claim rewards for my wallet address 0xABC...123 on yieldId eth-lido-steth using the passthrough value from my pending actions — I'll sign it myself.","exampleUseCases":[{"title":"Claim staking rewards automatically","prompt":"I've got pending rewards sitting in my Lido position. Can you construct an unsigned transaction to claim them for wallet 0x742d35Cc6634C0532925a3b844Bc7e7595f42728? I'll review and sign it before broadcasting."},{"title":"Complete a DeFi withdrawal","prompt":"I'm trying to finish withdrawing my tokens from Aave. Build me an unsigned transaction to complete the withdrawal for yieldId aave-usdc-v3 on my wallet — just the transaction, I'll handle the signing."},{"title":"Restake pending yield rewards","prompt":"My staking rewards are ready to restake automatically. Can you construct the unsigned transaction to restake my pending rewards on yieldId eth-staking-solo for address 0x8F1e5B0ee778e2nF0A1eA02d1d3d3c3a3a3a3a3? I need to verify it first."}],"resultDescription":"Returns an unsigned transaction object that the caller must sign and broadcast to the blockchain. The transaction encodes the requested pending action (e.g. claim rewards, unlock, restake, complete withdrawal) for the given wallet and yield position.","failureModes":["Invalid action type not recognized (e.g. not CLAIM_REWARDS, UNLOCK, RESTAKE, COMPLETE_WITHDRAWAL)","Missing or invalid passthrough value — must come from yields_get_balances pendingActions[].passthrough","Invalid or malformed wallet address","yieldId not found or not eligible for the requested action","No pending action available for the given action type and position","Payment of 0.001 USDC not provided or rejected (x402)"],"whenToPreferThis":"Use this endpoint when you have a pending action (e.g. claimable rewards, unlockable tokens, completable withdrawal) identified from yields_get_balances and need to construct the unsigned transaction to execute it. This is the correct endpoint for post-deposit lifecycle management — not for initiating new stakes or deposits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:19:58.575Z","isFirstParty":false,"canonicalSlug":"yield-xyz-manage-pending-actions-claim-restake-unlock-withdraw-a3d0ab0a"}