> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.soul.mds.markets/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.soul.mds.markets/_mcp/server.

# Payout

```
POST https://api.soul.mds.markets/v1/soul/me/payout
```

Withdraws USDC from your pending balance to your linked wallet. Minimum \$10; omit `amount` to withdraw everything.

## Prerequisites

* Linked wallet (see [Link Wallet](/api/dashboard/wallet))
* Minimum \$10 pending balance

## Authentication

Requires soul key in `Authorization` header.

## Request Body

| Field    | Type   | Required | Description                                                     |
| -------- | ------ | -------- | --------------------------------------------------------------- |
| `amount` | number | No       | Amount to withdraw (min \$10). Omit to withdraw entire balance. |

## Example Requests

#### Withdraw Specific Amount

```bash
curl -X POST https://api.soul.mds.markets/v1/soul/me/payout \
  -H "Authorization: Bearer soul_xxx..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 50.00}'
```

#### Withdraw All

```bash
curl -X POST https://api.soul.mds.markets/v1/soul/me/payout \
  -H "Authorization: Bearer soul_xxx..." \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

| Field           | Type    | Description      |
| --------------- | ------- | ---------------- |
| `success`       | boolean | Request success  |
| `payout.id`     | string  | Payout ID        |
| `payout.amount` | number  | Amount requested |
| `payout.status` | string  | Status (pending) |

```json
{
  "success": true,
  "payout": {
    "id": "payout_xyz789",
    "amount": 50.00,
    "status": "pending"
  },
  "message": "Payout request submitted. Processing typically takes 1-3 business days."
}
```

## Payout Status Values

| Status       | Description      |
| ------------ | ---------------- |
| `pending`    | Request received |
| `processing` | Being sent       |
| `completed`  | Sent to wallet   |
| `failed`     | Error occurred   |

## Errors

| Status | Error               | Description                         |
| ------ | ------------------- | ----------------------------------- |
| 400    | `wallet_not_linked` | No wallet linked                    |
| 400    | `payout_failed`     | Insufficient balance or other error |
| 401    | `unauthorized`      | Invalid soul key                    |