Skip to main content
Sends money from your master wallet, or from one of your users’ addresses, to an address outside Minisend.
Call this from your server only, never from a browser or app, so your API key stays secret.
You name the address in each request. There’s no list of addresses to approve first, so your users can withdraw to their own wallets through your product. The one thing we refuse is an address that belongs to your own account: use a transfer to move money between your users.
Because any address is allowed, a key with the withdraw permission can send your balance anywhere. Turn that permission on only for the keys that need it, keep them on your server, and revoke a key straight away if you think it’s been exposed.

Endpoint

The key needs the 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

string
required
"master" to withdraw from your master wallet, or the walletRef of the address to withdraw from.
string
required
The network to send on: BASE, MATIC, ARB, OP, ETH, AVAX, ARC, or SOL for Solana.
string
required
USDC or USDT.
number
required
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.
string
required
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.
string
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’s solana_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)

You get 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.
string
required
queued, sending, completed, or failed.
string
What you sent: "master", or the walletRef the money came from.
string
The blockchain transaction ID, once sent. null until then, and when failed.

Listing your withdrawals

Needs a key with wallets:read.
number
default:"20"
How many to return at once, up to 100.
number
default:"0"
How many to skip. Use it to get the next page.
Each one has the same fields as the response above.

Errors