v32

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-076085232.1 KB

Portfolio

Withdraw tokens from server wallet

Transfer ERC20 tokens from a managed sub-account server wallet to the partner's own address. Requires "withdrawal" scope. Destination must be the authenticated account, smart wallet, or a whitelisted withdrawal address. When destination is omitted, Etherspot profiles withdraw to their smart wallet if one exists. When onBehalfOf is set, the whitelist used is the authenticated caller's whitelist, not the target sub-account's.

post/portfolio/withdraw

Request body

amountstring required

Amount to withdraw in the smallest token unit (e.g. 1000000 = 1 USDC)

tokenstring

ERC20 token address to withdraw. Defaults to USDC if omitted.

destinationstring

Destination address for the withdrawal. Must be the authenticated account, smart wallet, or an active whitelisted withdrawal address. Defaults to the Etherspot smart wallet when available, otherwise the authenticated account. When onBehalfOf is set, the whitelist used is the authenticated caller's whitelist, not the target sub-account's.

onBehalfOfnumber

Profile ID of the managed sub-account (partner flow). Must be a child of the authenticated partner.

Example request

{
  "amount": "1000000"
}

Response

Withdrawal transaction submitted