Skip to main content
POST
Withdraw from a wallet
Withdrawals are made with your API key. API calls are only accepted from your allowed IP addresses, which are required: keep this list limited to your own servers, and keep your keys secret, on those servers only. A key used from any other address is refused.
A blockchain transfer cannot be cancelled or reversed. Check that address is an address on the blockchain of the wallet before you call: funds sent to a wrong address are permanently lost.

Authorizations

Authorization
string
header
required

API key (sk_test_... or sk_live_...)

Path Parameters

code
string<uuid>
required

Code of the wallet to withdraw from: the code returned when the wallet is created (POST /wallets).

Body

application/json
address
string
required

Destination address, on the blockchain of the wallet. It cannot be the address of the wallet itself.

Example:

"DESTINATION_SOLANA_ADDRESS"

amount
number
required

Amount debited from the balance of the wallet, in USD, fees included. Must be greater than 0.

Example:

100

idempotency_key
string

Optional. Your own unique key for this withdrawal (1 to 64 characters), for example the id of the request in your system. The same key on the same wallet returns the existing withdrawal instead of creating a new one.

Maximum string length: 64
Example:

"payout-5521"

Response

A withdrawal with this idempotency_key already exists on this wallet. It is returned as is, with its current status, and nothing is debited.

success
boolean
Example:

true

data
object
meta
object