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.

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.

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 for response fields.