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.
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 Amount to withdraw in USD terms.
On-chain destination address. Use an EVM hex address for EVM chains or a base58 address for solana.
Response
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).