private/submit_transfer_to_user

Transfer funds to another user. This method allows you to send funds from your main account to another Deribit user’s account. The transfer is processed internally and does not require blockchain transactions.

📖 Related Article: Managing Transfers

Scope: wallet:read_write and mainaccount

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/submit_transfer_to_user \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 9421,
  "method": "private/submit_transfer_to_user",
  "params": {
    "currency": "ETH",
    "amount": 13.456,
    "destination": "0x4aa0753d798d668056920094d65321a8e8913e26"
  }
}
'

import requests

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

payload = {
    "jsonrpc": "2.0",
    "id": 9421,
    "method": "private/submit_transfer_to_user",
    "params": {
        "currency": "ETH",
        "amount": 13.456,
        "destination": "0x4aa0753d798d668056920094d65321a8e8913e26"
    }
}
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: 9421,
    method: 'private/submit_transfer_to_user',
    params: {
      currency: 'ETH',
      amount: 13.456,
      destination: '0x4aa0753d798d668056920094d65321a8e8913e26'
    }
  })
};

fetch('https://test.deribit.com/api/v2/private/submit_transfer_to_user', 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/submit_transfer_to_user",
  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' => 9421,
    'method' => 'private/submit_transfer_to_user',
    'params' => [
        'currency' => 'ETH',
        'amount' => 13.456,
        'destination' => '0x4aa0753d798d668056920094d65321a8e8913e26'
    ]
  ]),
  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/submit_transfer_to_user"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 9421,\n  \"method\": \"private/submit_transfer_to_user\",\n  \"params\": {\n    \"currency\": \"ETH\",\n    \"amount\": 13.456,\n    \"destination\": \"0x4aa0753d798d668056920094d65321a8e8913e26\"\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/submit_transfer_to_user")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 9421,\n  \"method\": \"private/submit_transfer_to_user\",\n  \"params\": {\n    \"currency\": \"ETH\",\n    \"amount\": 13.456,\n    \"destination\": \"0x4aa0753d798d668056920094d65321a8e8913e26\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": 9421,\n  \"method\": \"private/submit_transfer_to_user\",\n  \"params\": {\n    \"currency\": \"ETH\",\n    \"amount\": 13.456,\n    \"destination\": \"0x4aa0753d798d668056920094d65321a8e8913e26\"\n  }\n}"

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

200

{
  "jsonrpc": "2.0",
  "id": 9187,
  "result": {
    "amount": 0.2,
    "created_timestamp": 1550579457727,
    "currency": "BTC",
    "direction": "payment",
    "id": 2,
    "other_side": "2MzyQc5Tkik61kJbEpJV5D5H9VfWHZK9Sgy",
    "state": "cancelled",
    "type": "user",
    "updated_timestamp": 1550579457727
  }
}

Query Parameters

currency · enum<string> · required

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

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

amount · number · required

Amount of funds to be transferred

destination · string · required

Destination wallet's address taken from address book

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. id · integer · required

Id of transfer

Example:

12

result. created_timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result. type · enum<string> · required

Type of transfer: user - sent to user, subaccount - sent to subaccount

Available options: user, subaccount

result. currency · enum<string> · required

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

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

result. amount · number · required

Amount of funds in given currency

Example:

1

result. other_side · string · required

For transfer from/to subaccount returns this subaccount name, for transfer to other account returns address, for transfer from other account returns that accounts username.

Example:

"Smith"

result. state · string · required

Transfer state, allowed values : prepared, confirmed, cancelled, waiting_for_admin, insufficient_funds, withdrawal_limit otherwise rejection reason

result. updated_timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result. direction · enum<string>

Transfer direction

Available options: payment, income

result. nonce · string

Optional idempotency nonce if provided in the request

id · integer

The id that was sent in the request