> For the complete documentation index, see [llms.txt](https://docs.anchored.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.anchored.finance/trading-api/cash-operations/withdrawals.md).

# Withdrawals

Withdrawals deduct `mUSD` (`mUsdBalance`) and return cash tokens to the user. They may complete instantly if the token withdrawal buffer has enough liquidity; otherwise they are queued for final cash settlement. See [buffer-mechanism.md](/trading-api/cash-operations/buffer-mechanism.md).

## Build withdrawal calldata

```
POST /api/v1/cash/withdrawals/calldata
```

| Field          | Type            | Required | Description                          |
| -------------- | --------------- | -------- | ------------------------------------ |
| `userAddress`  | string          | Yes      | User wallet.                         |
| `tokenAddress` | string          | Yes      | Cash token address.                  |
| `creditAmount` | string / number | Yes      | Credit to withdraw (human-readable). |

Returns `method: withdraw`, `value: "0"`.

## One Click withdrawal

```
POST /api/v1/cash/withdrawals/send
```

Same body fields as calldata (no `userAddress` in body — uses API key bound address). Optional `gasLimit`.

Requires One Click enabled — see [trading/one-click-delegated.md](/trading-api/trading/one-click-delegated.md).

## Record withdrawal tx

```
POST /api/v1/cash/withdrawals/tx
```

| Field    | Type   | Required | Description         |
| -------- | ------ | -------- | ------------------- |
| `txHash` | string | Yes      | Withdrawal tx hash. |

## Query withdrawals

```
GET /api/v1/cash/withdrawals?page=1&limit=10
GET /api/v1/cash/withdrawals/{operationId}
```

See [operation-status.md](/trading-api/cash-operations/operation-status.md) for response fields.
