cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_current_deposit_address \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 3461,
  "method": "private/get_current_deposit_address",
  "params": {
    "currency": "BTC"
  }
}
'

import requests

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

payload = {
    "jsonrpc": "2.0",
    "id": 3461,
    "method": "private/get_current_deposit_address",
    "params": { "currency": "BTC" }
}
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: 3461,
    method: 'private/get_current_deposit_address',
    params: {currency: 'BTC'}
  })
};

fetch('https://test.deribit.com/api/v2/private/get_current_deposit_address', 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/get_current_deposit_address",
  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' => 3461,
    'method' => 'private/get_current_deposit_address',
    'params' => [
        'currency' => 'BTC'
    ]
  ]),
  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/get_current_deposit_address"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\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/get_current_deposit_address")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}"

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

{
  "jsonrpc": "2.0",
  "id": 3461,
  "result": {
    "address": "2N8udZGBc1hLRCFsU9kGwMPpmYUwMFTuCwB",
    "creation_timestamp": 1550575165170,
    "currency": "BTC",
    "type": "deposit"
  }
}

Wallet

private/get_current_deposit_address

Retrieve the current deposit address for the specified currency. Returns the most recently created or used deposit address for receiving funds.

Coinbase wallet type

For Coinbase wallet type accounts the network parameter is required and selects the blockchain network of the deposit address. The networks available for each currency are returned by public/get_currencies in the coinbase_networks field. Returns null when no deposit address exists for the given currency and network. This method is available to institutional Coinbase accounts only.

📖 Related Article: Managing Deposits

Scope: wallet:read

Try in API console

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_current_deposit_address \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 3461,
  "method": "private/get_current_deposit_address",
  "params": {
    "currency": "BTC"
  }
}
'

import requests

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

payload = {
    "jsonrpc": "2.0",
    "id": 3461,
    "method": "private/get_current_deposit_address",
    "params": { "currency": "BTC" }
}
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: 3461,
    method: 'private/get_current_deposit_address',
    params: {currency: 'BTC'}
  })
};

fetch('https://test.deribit.com/api/v2/private/get_current_deposit_address', 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/get_current_deposit_address",
  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' => 3461,
    'method' => 'private/get_current_deposit_address',
    'params' => [
        'currency' => 'BTC'
    ]
  ]),
  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/get_current_deposit_address"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\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/get_current_deposit_address")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": 3461,\n  \"method\": \"private/get_current_deposit_address\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}"

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

{
  "jsonrpc": "2.0",
  "id": 3461,
  "result": {
    "address": "2N8udZGBc1hLRCFsU9kGwMPpmYUwMFTuCwB",
    "creation_timestamp": 1550575165170,
    "currency": "BTC",
    "type": "deposit"
  }
}

Query Parameters

currency

enum<string>

required

The currency symbol.

📖 Related Article: Using the currency Parameter

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

Available options:

BTC,

ETH,

USDC,

USDT,

EURR

network

string

Blockchain network for the wallet operation, given as a network resource name (e.g. "networks/ethereum-mainnet"). Coinbase wallet type only. The networks available for each currency are returned by public/get_currencies in the coinbase_networks field. Required for operations that target an on-chain address or a deposit address; also used to disambiguate address book entries when the same address exists on multiple networks.

Example:

"networks/ethereum-mainnet"

Response

200 - application/json

Success response

jsonrpc

enum<string>

required

The JSON-RPC version (2.0)

Available options:

2.0

result

object

required

Object if address is created, null otherwise

Option 1
Option 2

Hide child attributes

result.creation_timestamp

integer

required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result.currency

enum<string>

required

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

Available options:

BTC,

ETH,

USDC,

USDT,

EURR

result.address

string

required

Address in proper format for currency

Example:

"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

result.type

string

required

Address type/purpose, allowed values : deposit

integer

The id that was sent in the request

Methods overview

Methods

private/get_current_deposit_address

Query Parameters

Response