Endpoint
withdraw permission (scope). It’s off on every key to start with, including older keys, so turn it on only for a key that should be able to send money out.
Body
"master" to withdraw from your master wallet, or the walletRef of the address to withdraw from.A positive amount of the coin. If it has more decimal places than the coin allows, we refuse it rather than round it, because rounding could send more than you meant to.
The address to send to. It has to be an address on the network in
chain: a 0x address everywhere except Solana, and a Solana address on SOL. It can’t be one of your own addresses.Any text unique to this withdrawal. If you send the same key with the same request again, you get the original withdrawal back instead of a second one. Sending it with a different
source, chain, token, amount, or destination_address is refused with 409.Example
Minimum amounts
Withdrawing on Solana
On Solana you send from the wallet’ssolana_address (or your Solana master wallet), so pass chain: "SOL". A few things work differently there:
- Send to a wallet address, not a token account. On Solana, each wallet holds a coin in a separate account linked to it. If you send to one of those token accounts directly instead of the wallet it belongs to, the money can be lost, so we refuse it with a
400. Ask your user for their main wallet address. - Keep the address exactly as it is. Solana addresses are case-sensitive. Changing a letter from upper to lower case gives you a different address that nobody owns.
- The first payment to a new address costs a little more. When an address has never held that coin, the network charges a one-time fee of about $0.30 to set it up. We pass it on at cost. That’s why the smallest Solana withdrawal is 0.5.
Response (202)
202, not 200, because we’ve accepted the withdrawal and send it shortly after. Check get a withdrawal or wait for wallet.withdrawal.completed to see how it went. If you send an idempotency_key you’ve used before, you get 200 with the original withdrawal.
Listing your withdrawals
wallets:read.

