v11

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-023710598.2 KB

Wallets

Withdraw funds from a smart wallet

post/wallets/{address}:withdraw

Request body

recipientAddressstring required

Lowercase or checksummed hex EOA / contract address.

amountstring required

Amount in wei (decimal string) or max for the full balance.

tokenstring required

ETH for native token, or an ERC-20 contract address.

chainIdinteger

Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filter params it is optional.

Example request

{
  "recipientAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
  "chainId": 11155111
}

Response

Withdrawal submitted (UserOp may still be in flight).

status'pending' | 'confirmed' | 'failed' required

messagestring

userOpHashstring

Arbitrary-length hex-encoded byte string.

transactionHashstring

Arbitrary-length hex-encoded byte string.

submittedAtinteger

smartWalletAddressstring

Lowercase or checksummed hex EOA / contract address.

recipientAddressstring

Lowercase or checksummed hex EOA / contract address.

amountstring

tokenstring

Example response

{
  "smartWalletAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB",
  "recipientAddress": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
}