Withdraw funds
Initiates a withdrawal from the wallet. Idempotent on requestId — if a withdrawal with the same requestId already exists, the existing withdrawal is returned. The token is required. USDC supports the documented CCTP chain set; USDT supports Ethereum only in production and Ethereum Sepolia in sandbox. Wallets without automatic rebalancing may provide sources to choose the exact wallet positions and gross dollar amounts debited. Omit sources to preserve automatic source selection.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Wallet ID
Body
Client-generated idempotency key (UUID v4).
Stablecoin lane used to validate, fund, rebalance, and withdraw an allocation independently from other token lanes.
usdc, usdt Destination chain for the withdrawal. Production chains are arbitrum, base, ethereum, polygon, and solana; sandbox accepts ethereum_sepolia and solana_devnet.
arbitrum, base, ethereum, ethereum_sepolia, polygon, solana, solana_devnet Gross wallet value to withdraw before execution fees. The destination receives this amount minus reported fees.
On-chain destination address. Use an EVM hex address for EVM chains or a base58 address for solana.
Optional exact gross source split when automatic rebalancing is disabled. Amounts must sum to amountUsd.
1Response
Withdrawal initiated (or existing withdrawal returned for idempotent retry)
Requested withdrawal amount in USD as a formatted string.
Completed payout amount in USD as a formatted string. Null until at least one payout completes.
Fee charged for the withdrawal as a formatted string.
Destination chain for the withdrawal.
arbitrum, base, ethereum, ethereum_sepolia, polygon, solana, solana_devnet usdc, usdt Simplified withdrawal status. partially_completed means at least one payout leg delivered value and at least one leg failed or was cancelled.
processing, completed, partially_completed, failed, cancelled Source-to-destination payout workflow legs.
Human-readable reason for failure (only present when status is failed).