---
title: "Withdraw"
method: POST
path: "/v1/wallets/{walletId}/rewards/withdraw"
tags: ["Rewards"]
---

# Withdraw

`POST /v1/wallets/{walletId}/rewards/withdraw`

Withdraws from an earn position. The `amount` is the **net** amount you receive — the platform grosses up the redemption so the fee is taken from realized yield only. Pass `"max"` to fully exit (closes the position). Asynchronous — returns a `PENDING` transaction; completion is delivered via webhook.

### Body Parameters

| Key | Required | Type | Description |
| --- | --- | --- | --- |
| assetId | true | string (UUID) | The asset to withdraw. |
| amount | true | string | Net amount to withdraw, or `"max"` for a full exit. |
| type | false | string | Strategy class: `regulated` or `defi`. |
| address | false | string | External destination address. Omit to credit the signer (master wallet or sub-address). |
| reference | false | string | Client reference. |
| metadata | false | object | Custom metadata. |
| addressId | false | string (UUID) | Scope the operation to a sub-address. Omit to act on the master wallet. |

## Request body

- object
  - `assetId` string
  - `amount` string
  - `type` string
  - `address` string
  - `reference` string
  - `metadata` object
  - `addressId` string

## Response `200`

OK

- object

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/revisions/97f95b4cfc0d/schema)