Skip to main content
POST
/
trade
/
withdrawals
Cryptocurrency Withdrawals - Create Cryptocurrency Withdrawal
curl --request POST \
  --url https://api.ripio.com/trade/withdrawals \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'signature: <signature>' \
  --header 'timestamp: <timestamp>' \
  --data '
{
  "amount": 7.77,
  "destination": "1AU4BoYaxSunkEWikEMYXJ41c9bvQG6Wa2",
  "currency_code": "<string>",
  "fee_included": true,
  "external_id": "2352b104-3f8c-47da-b817-46c942350c95",
  "tag": "<string>",
  "network": "bitcoin",
  "memo": "<string>"
}
'
{
  "data": {
    "id": "A1DCD3B6-1CBD-4F17-ADA0-230ADEC04173",
    "amount": 0.1,
    "create_date": "2019-01-25T16:37:15.443Z",
    "currency_code": "BTC",
    "destination_address": "rw9nf3WgsagJiZnkAeZzXZuqeCQ6LHm2h1",
    "link": null,
    "miner_fee": 0,
    "status": "<string>",
    "transaction_id": null,
    "update_date": "2019-01-25T16:37:15.443Z",
    "fee": 0,
    "hash": null,
    "external_id": "rtd-9012-lkju-908",
    "network": "bitcoin",
    "memo": "<string>",
    "tag": "<string>"
  },
  "error_code": null,
  "message": null
}

Headers

​
authorization
string
required

The API key as a string.

​
signature
string
required

See the Generating Signature section for more details.

​
timestamp
number
required

A timestamp in milliseconds. See the Timestamp Security section for more details.

​
timstamp-tolerance
number

An additional, non-required parameter, that you can send to specify the number of milliseconds after the timestamp for the request to be valid. See the Timestamp Security section for more details.

Body

application/json
​
amount
number
required

Amount

Example:

7.77

​
destination
string
required

Destination address. This address needs to be bound to a registered wallet. You can register a wallet on: https://trade.ripio.com/market/api/wallets

Example:

"1AU4BoYaxSunkEWikEMYXJ41c9bvQG6Wa2"

​
currency_code
string
required

Currency code

​
fee_included
boolean

If true, the fee is deducted from the amount specified. This means the total charge remains exactly equal to the requested amount, and the recipient receives the net amount after the fee is subtracted. Example: If you request a withdrawal of 100 and the fee is 1, the user is charged 100 and receives 99. Default value is true.

Example:

true

​
external_id
string

Withdrawal external identifier (maximum of 36 chars)

Example:

"2352b104-3f8c-47da-b817-46c942350c95"

​
tag
string

Destination tag

⚠️ Check the information about this currency in the public currencies endpoint to check if this currency offers tag for withdrawals, and if has tag for deposit in case of a Ripio Trade address destination

​
network
string

Destination network

Example:

"bitcoin"

​
memo
string

Destination memo

⚠️ Check the information about this currency in the public currencies endpoint to check if this currency offers memo for withdrawals, and if has memo for deposit in case of a Ripio Trade address destination

Response

200 - application/json

Ok

​
data
object
required

From T, pick a set of properties whose keys are in the union K

​
error_code
number
required
Example:

null

​
message
string
required
Example:

null