private/withdraw

Creates a new withdrawal request. This method allows you to withdraw funds from your account to an external address. The withdrawal can be configured with priority settings and must use an address from your address book.

Withdrawal Checks & Balance Updates

Withdrawal funds are checked twice: when a user requests a withdrawal and again when they confirm it via the email link. If available funds decrease between these steps, the withdrawal may be rejected.

A withdrawal may also be rejected if the on-chain fee increases between the request and confirmation.

The withdrawal amount is deducted only after all checks pass and the transaction is scheduled. The web-interface Withdrawal tab displays all withdrawals regardless of their status (pending, cancelled, rejected, or completed).

📖 Related Article: Managing Withdrawals

Scope: wallet:read_write and mainaccount

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/withdraw \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 6931,
  "method": "private/withdraw",
  "params": {
    "currency": "BTC",
    "address": "2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz",
    "amount": 0.4,
    "priority": "mid"
  }
}
'

import requests

url = "https://test.deribit.com/api/v2/private/withdraw"

payload = {
    "jsonrpc": "2.0",
    "id": 6931,
    "method": "private/withdraw",
    "params": {
        "currency": "BTC",
        "address": "2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz",
        "amount": 0.4,
        "priority": "mid"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 6931,
    method: 'private/withdraw',
    params: {
      currency: 'BTC',
      address: '2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz',
      amount: 0.4,
      priority: 'mid'
    }
  })
};

fetch('https://test.deribit.com/api/v2/private/withdraw', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/private/withdraw",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 6931,
    'method' => 'private/withdraw',
    'params' => [
        'currency' => 'BTC',
        'address' => '2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz',
        'amount' => 0.4,
        'priority' => 'mid'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/private/withdraw"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 6931,\n  \"method\": \"private/withdraw\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"address\": \"2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz\",\n    \"amount\": 0.4,\n    \"priority\": \"mid\"\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/private/withdraw")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 6931,\n  \"method\": \"private/withdraw\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"address\": \"2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz\",\n    \"amount\": 0.4,\n    \"priority\": \"mid\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/private/withdraw")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 6931,\n  \"method\": \"private/withdraw\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"address\": \"2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz\",\n    \"amount\": 0.4,\n    \"priority\": \"mid\"\n  }\n}"

response = http.request(request)
puts response.read_body

200

{
  "jsonrpc": "2.0",
  "id": 7420,
  "result": {
    "address": "2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz",
    "amount": 0.5,
    "confirmed_timestamp": null,
    "created_timestamp": 1550571443070,
    "currency": "BTC",
    "fee": 0.0001,
    "id": 1,
    "priority": 0.15,
    "state": "cancelled",
    "transaction_id": null,
    "updated_timestamp": 1550571443070
  }
}

Query Parameters

currency · enum<string> · required

The currency symbol Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, EURR

address · string · required

Address in currency format, it must be in address book

amount · number · required

Amount of funds to be withdrawn

priority · enum<string>

Withdrawal priority, optional for BTC, default: high

Available options: insane, extreme_high, very_high, high, mid, low, very_low

nonce · string

Optional idempotency nonce. If provided, subsequent requests with the same nonce will return the previously created transaction instead of creating a new one. Must be 8-128 characters. The nonce is persisted on the resulting transaction and returned in the response. Nonce

Example:

"bF1_gfgcsd"

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object · required

Hide child attributes

result. address · string · required

Address in proper format for currency

Example:

"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

result. amount · number · required

Amount of funds in given currency

Example:

1

result. currency · enum<string> · required

Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, EURR

result. state · enum<string> · required

Withdrawal state, allowed values : unconfirmed, confirmed, cancelled, completed, interrupted, rejected

Available options: unconfirmed, confirmed, cancelled, completed, interrupted, rejected

result. transaction_id · string | null · required

Transaction id in proper format for currency, null if id is not available

Example:

"1b1fb5568515e2b79503501e3d3680b2d0838d5dfc2d15a04eb8cd9fbbe0b572"

result. updated_timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result. confirmed_timestamp · integer | null

The timestamp (milliseconds since the Unix epoch) of withdrawal confirmation, null when not confirmed

Example:

1536569522277

result. created_timestamp · integer

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result. fee · number

Fee in currency

Example:

0.000023

result. id · integer

Withdrawal id in Deribit system

Example:

1

result. priority · number

Id of priority level

Example:

1

result. nonce · string

Optional idempotency nonce if provided in the request

id · integer

The id that was sent in the request