Withdraw to External Address
Withdraw USDC from the embedded wallet to an external Solana address.
Authorizations
Privy JWT issued to the web dashboard. Sent as Authorization: Bearer <jwt>. The Privy session signer underpins all wallet-signed actions.
Headers
Client-generated UUID. Successful (2xx) responses are cached for 24h and replayed on retry with the same key. The request body is not part of the cache key — use a fresh UUID whenever the payload differs (e.g. updated odds), otherwise the original response is replayed. Non-2xx responses are not cached.
Body
Destination Solana wallet address (base58). Must be on-curve — PDAs, program IDs, and token-account addresses are rejected because funds sent to a derived ATA-of-an-ATA are unrecoverable.
USDC amount to send. Minimum is one USDC base unit (1e-6). Must be ≤ the caller's total spendable pool (ATA + vault free_balance − in-flight RFQ holds); requests exceeding this are rejected with 400.
x >= 0.000001Response
Withdrawal submitted. signature is the external SPL transfer
signature. vault_signature and vault_amount are present
only when the request required a vault → ATA hop.
