Preview a withdrawal
Returns the withdrawable balance for a given destination chain and, optionally, validates that a specific withdrawal amount is feasible. 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. Source amounts must sum to amountUsd.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Wallet ID
Body
Target chain for the withdrawal. Use ethereum_sepolia or solana_devnet for sandbox testing.
arbitrum, base, ethereum, ethereum_sepolia, polygon, solana, solana_devnet Stablecoin lane used to validate, fund, rebalance, and withdraw an allocation independently from other token lanes.
usdc, usdt Gross wallet value to withdraw before execution fees. If omitted, the preview uses the maximum gross withdrawable amount.
Optional exact gross source split when automatic rebalancing is disabled. Omit it to let Ground select sources automatically.
1Response
Withdrawal preview
Gross wallet value evaluated by this preview. Equals the requested amount, or the resolved maximum gross withdrawable amount when amountUsd was omitted.
Estimated execution fee deducted from the gross requested amount, including yield source protocol exit fees.
Estimated net amount to be sent to the destination after execution fees are deducted from the gross requested amount.
Maximum gross wallet value that can safely start a new withdrawal for this destination right now.
Estimated wallet total after the gross requested amount is removed.
- Option 1
- Option 2