# yield.xyz Manage Pending Actions (Claim, Restake, Unlock, Withdraw)

> yield.xyz Manage Pending Actions (Claim, Restake, Unlock, Withdraw) is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-28).

Constructs unsigned blockchain transactions for pending yield actions such as claiming rewards, restaking, unlocking, or completing withdrawals — caller must sign and submit.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/actions_manage?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-manage-pending-actions-claim-restake-unlock-withdraw-a3d0ab0a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1WR0Be-ExGqGiXrEkZJdB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yield-xyz-manage-pending-actions-claim-restake-unlock-withdraw-a3d0ab0a -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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)

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-manage-pending-actions-claim-restake-unlock-withdraw-a3d0ab0a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)