Fast-track release: this endpoint is available in the API now, while SDK helper methods are still pending.
- Route:
POST /portfolio/withdraw - Auth:
apiToken, Privy, or session auth - Scope:
withdrawalwhen usingapiToken
Request body
| Field | Type | Required | Description |
|---|---|---|---|
amount | string | Yes | Token amount in smallest unit (for USDC: 1000000 = 1 USDC). |
token | string | No | ERC20 token address. Defaults to USDC when omitted. |
destination | string | No | Destination address. Must be one of the authenticated partner’s own addresses (account or smart wallet). |
onBehalfOf | number | No | Managed sub-account profile id (partner flow). Must be a child of the authenticated partner profile. |
Example (HMAC)
Notes
- Destination defaults to the authenticated account if omitted.
- Destination validation blocks withdrawals to third-party addresses.
- Legacy API keys are not supported on server-wallet operations.