> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Exit (withdraw from) a yield position on Yield.xyz by generating unsigned transactions via the Actions API. Use when the user wants to unstake, withdraw, exit a lending position, or remove liquidity from any yield opportunity.

# SKILL

# Exit Position

Generate the transactions needed to exit (withdraw from) a yield position using the Yield.xyz Actions API. This skill covers unstaking, withdrawing from lending protocols, exiting vaults, and handling cooldown periods.

## When to Use

Activate this skill when the user asks to:

* Unstake tokens (e.g., "Unstake my ETH from Lido")
* Withdraw from a lending protocol (e.g., "Withdraw USDC from Aave")
* Exit a vault position
* Remove liquidity
* Stop earning yield on a position
* Claim unstaked/unlocked tokens

## Authentication

```
x-api-key: YOUR_API_KEY
```

## Base URL

```
https://api.yield.xyz/v1
```

## Step-by-Step Instructions

### Step 1: Verify the Yield Supports Exits

```bash theme={null}
curl "https://api.yield.xyz/v1/yields/{yieldId}" \
  -H "x-api-key: $YIELD_API_KEY"
```

Confirm `status.exit` is `true`. Check `metadata.cooldownPeriod` for any withdrawal waiting period.

### Step 2: Check Current Balance (Recommended)

Before exiting, verify the user has a position:

```bash theme={null}
curl -X POST "https://api.yield.xyz/v1/yields/{yieldId}/balances" \
  -H "x-api-key: $YIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xUserWalletAddress"
  }'
```

This confirms the user has an active position and shows available balance types (staked, unstaking, claimable, etc.).

### Step 3: Create the Exit Action

**Endpoint:** `POST /v1/actions/exit`

**Request Body (CreateActionDto):**

```json theme={null}
{
  "yieldId": "ethereum-eth-lido-staking",
  "address": "0xYourWalletAddress",
  "arguments": {
    "amount": "1000000000000000000"
  }
}
```

**For full withdrawal (vaults):**

Some ERC-4626 vaults support `useMaxAmount`:

```json theme={null}
{
  "yieldId": "ethereum-usdc-morpho-vault",
  "address": "0xYourWalletAddress",
  "arguments": {
    "useMaxAmount": true
  }
}
```

**With validator (staking):**

```json theme={null}
{
  "yieldId": "cosmos-atom-native-staking",
  "address": "cosmos1youraddress...",
  "arguments": {
    "amount": "1000000",
    "validatorAddress": "cosmosvaloper1..."
  }
}
```

**cURL Example:**

```bash theme={null}
curl -X POST "https://api.yield.xyz/v1/actions/exit" \
  -H "x-api-key: $YIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "yieldId": "ethereum-eth-lido-staking",
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "arguments": {
      "amount": "500000000000000000"
    }
  }'
```

**Response (ActionDto):**

```json theme={null}
{
  "id": "action_xyz789",
  "intent": "exit",
  "type": "UNSTAKE",
  "status": "CREATED",
  "transactions": [
    {
      "id": "tx_003",
      "type": "UNSTAKE",
      "status": "CREATED",
      "unsignedTransaction": "0x..."
    }
  ]
}
```

### Step 4: Sign and Submit Each Transaction

For each transaction in the `transactions` array, in order:

1. **Sign** the `unsignedTransaction` using the user's wallet
2. **Broadcast** the signed transaction to the blockchain
3. **Submit the hash** to Yield.xyz:

```bash theme={null}
curl -X PUT "https://api.yield.xyz/v1/transactions/{transactionId}/submit-hash" \
  -H "x-api-key: $YIELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "hash": "0xTransactionHashHere..." }'
```

### Step 5: Handle Cooldown Periods

Many staking yields have cooldown periods after unstaking:

| Network / Protocol                 | Typical Cooldown                  |
| ---------------------------------- | --------------------------------- |
| Ethereum native staking            | Variable (exit queue, \~1-5 days) |
| Cosmos (ATOM)                      | 21 days                           |
| Polkadot (DOT)                     | 28 days                           |
| Solana (SOL)                       | \~2-3 days (1 epoch)              |
| Avalanche (AVAX)                   | 14 days (delegator)               |
| Lido (stETH)                       | Up to \~4 days                    |
| Lending protocols (Aave, Compound) | Instant                           |
| ERC-4626 vaults                    | Usually instant                   |

After the cooldown period, the user may need to execute a **claim\_unstaked** action using the `manage-position` skill.

### Step 6: Verify Action Completion

```bash theme={null}
curl "https://api.yield.xyz/v1/actions/{actionId}" \
  -H "x-api-key: $YIELD_API_KEY"
```

## Exit Action Types

| Type           | Description                               |
| -------------- | ----------------------------------------- |
| `UNSTAKE`      | Initiate unstaking (may trigger cooldown) |
| `WITHDRAW`     | Direct withdrawal (lending, vaults)       |
| `WITHDRAW_ALL` | Withdraw entire position                  |
| `REVOKE`       | Revoke delegation (some networks)         |

## Error Handling

| Status Code | Meaning            | Action                                                |
| ----------- | ------------------ | ----------------------------------------------------- |
| 400         | Invalid parameters | Check amount doesn't exceed balance; verify arguments |
| 401         | Unauthorized       | Verify API key                                        |
| 403         | Geoblocked         | User's region is restricted                           |
| 404         | Yield not found    | Verify yield ID                                       |
| 429         | Rate limited       | Wait and retry                                        |

## Edge Cases

* **Partial exits:** Most yields support partial withdrawals. Specify the exact amount to withdraw.
* **Cooldown in progress:** If the user already has an unstaking request in cooldown, some protocols allow additional unstake requests while others don't. Check balances for `unstaking` balance types.
* **WETH unwrapping:** Some ERC-4626 vault exits with WETH as the underlying token will automatically unwrap to ETH.
* **Price per share:** Vault withdrawals convert the user's share amount using the current price-per-share, which may differ from the deposit amount due to yield accrual.
* **Minimum withdrawal:** Some protocols have minimum withdrawal amounts.
* **Instant vs delayed:** Lending protocols and most vaults process withdrawals instantly. Native staking typically has a cooldown period.
* **Claim after cooldown:** After a staking cooldown completes, use the `manage-position` skill with `CLAIM_UNSTAKED` action to claim the tokens.