cURL
curl --request GET \
--url https://drb.coinbase.com/api/v2/private/execute_block_trade \
--header 'Content-Type: application/json' \
--data '
{
"id": 1,
"jsonrpc": "2.0",
"method": "private/execute_block_trade",
"params": {
"counterparty_signature": "1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI",
"nonce": "bszyprbq",
"role": "maker",
"timestamp": 1590485535899,
"trades": [
{
"amount": 200000,
"direction": "sell",
"instrument_name": "BTC-PERPETUAL",
"price": 8900
},
{
"amount": 5,
"direction": "sell",
"instrument_name": "BTC-28MAY20-9000-C",
"price": 0.0133
}
]
}
}
'import requests
url = "https://drb.coinbase.com/api/v2/private/execute_block_trade"
payload = {
"id": 1,
"jsonrpc": "2.0",
"method": "private/execute_block_trade",
"params": {
"counterparty_signature": "1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI",
"nonce": "bszyprbq",
"role": "maker",
"timestamp": 1590485535899,
"trades": [
{
"amount": 200000,
"direction": "sell",
"instrument_name": "BTC-PERPETUAL",
"price": 8900
},
{
"amount": 5,
"direction": "sell",
"instrument_name": "BTC-28MAY20-9000-C",
"price": 0.0133
}
]
}
}
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({
id: 1,
jsonrpc: '2.0',
method: 'private/execute_block_trade',
params: {
counterparty_signature: '1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI',
nonce: 'bszyprbq',
role: 'maker',
timestamp: 1590485535899,
trades: [
{
amount: 200000,
direction: 'sell',
instrument_name: 'BTC-PERPETUAL',
price: 8900
},
{
amount: 5,
direction: 'sell',
instrument_name: 'BTC-28MAY20-9000-C',
price: 0.0133
}
]
}
})
};
fetch('https://drb.coinbase.com/api/v2/private/execute_block_trade', 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://drb.coinbase.com/api/v2/private/execute_block_trade",
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([
'id' => 1,
'jsonrpc' => '2.0',
'method' => 'private/execute_block_trade',
'params' => [
'counterparty_signature' => '1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI',
'nonce' => 'bszyprbq',
'role' => 'maker',
'timestamp' => 1590485535899,
'trades' => [
[
'amount' => 200000,
'direction' => 'sell',
'instrument_name' => 'BTC-PERPETUAL',
'price' => 8900
],
[
'amount' => 5,
'direction' => 'sell',
'instrument_name' => 'BTC-28MAY20-9000-C',
'price' => 0.0133
]
]
]
]),
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://drb.coinbase.com/api/v2/private/execute_block_trade"
payload := strings.NewReader("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\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://drb.coinbase.com/api/v2/private/execute_block_trade")
.header("Content-Type", "application/json")
.body("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://drb.coinbase.com/api/v2/private/execute_block_trade")
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 \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"result": {
"id": "61",
"timestamp": 1565089523720,
"trades": [
{
"amount": 10,
"block_trade_id": "61",
"direction": "sell",
"fee": 0.00025,
"fee_currency": "BTC",
"index_price": 11738,
"instrument_name": "BTC-9AUG19-10250-C",
"iv": 0,
"liquidity": "T",
"matching_id": null,
"order_id": "343062",
"order_type": "limit",
"price": 0.0001,
"state": "filled",
"tick_direction": 3,
"timestamp": 1565089523719,
"trade_id": "92437",
"trade_seq": 37
},
{
"amount": 190,
"block_trade_id": "61",
"direction": "buy",
"fee": 0.00000164,
"fee_currency": "BTC",
"index_price": 11737.98,
"instrument_name": "BTC-PERPETUAL",
"liquidity": "T",
"matching_id": null,
"order_id": "343058",
"order_type": "limit",
"price": 11590,
"state": "filled",
"tick_direction": 3,
"timestamp": 1565089523719,
"trade_id": "92435",
"trade_seq": 25350
}
]
}
}Block Trade
private/execute_block_trade
Executes a block trade. This is the second step in the block trade workflow - the second party calls this method with the signature received from the first party to execute the trade.
The whole request must be exactly the same as in private/verify_block_trade, only the role field should be set appropriately - this means that both sides have to agree on the same timestamp, nonce, and trades fields, and the server will ensure that the role field is different between sides (each party accepts their own role).
Using the same timestamp and nonce by both sides in private/verify_block_trade ensures that even if unintentionally both sides execute the given block trade with a valid counterparty_signature, the block trade will be executed only once.
Note: In the API, the direction field is always expressed from the maker’s perspective. This means that when you accept a block trade as a taker, the direction shown in the API represents the opposite side of your trade. For example, if you are buying puts as a taker, the API will show the operation as a “sell put” (maker’s perspective), and you will be verifying and accepting a “sell put” block trade.
📖 Related Article: Block Trading
Scope: rat#trade or wallet:buys:create
GET
/
private
/
execute_block_trade
cURL
curl --request GET \
--url https://drb.coinbase.com/api/v2/private/execute_block_trade \
--header 'Content-Type: application/json' \
--data '
{
"id": 1,
"jsonrpc": "2.0",
"method": "private/execute_block_trade",
"params": {
"counterparty_signature": "1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI",
"nonce": "bszyprbq",
"role": "maker",
"timestamp": 1590485535899,
"trades": [
{
"amount": 200000,
"direction": "sell",
"instrument_name": "BTC-PERPETUAL",
"price": 8900
},
{
"amount": 5,
"direction": "sell",
"instrument_name": "BTC-28MAY20-9000-C",
"price": 0.0133
}
]
}
}
'import requests
url = "https://drb.coinbase.com/api/v2/private/execute_block_trade"
payload = {
"id": 1,
"jsonrpc": "2.0",
"method": "private/execute_block_trade",
"params": {
"counterparty_signature": "1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI",
"nonce": "bszyprbq",
"role": "maker",
"timestamp": 1590485535899,
"trades": [
{
"amount": 200000,
"direction": "sell",
"instrument_name": "BTC-PERPETUAL",
"price": 8900
},
{
"amount": 5,
"direction": "sell",
"instrument_name": "BTC-28MAY20-9000-C",
"price": 0.0133
}
]
}
}
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({
id: 1,
jsonrpc: '2.0',
method: 'private/execute_block_trade',
params: {
counterparty_signature: '1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI',
nonce: 'bszyprbq',
role: 'maker',
timestamp: 1590485535899,
trades: [
{
amount: 200000,
direction: 'sell',
instrument_name: 'BTC-PERPETUAL',
price: 8900
},
{
amount: 5,
direction: 'sell',
instrument_name: 'BTC-28MAY20-9000-C',
price: 0.0133
}
]
}
})
};
fetch('https://drb.coinbase.com/api/v2/private/execute_block_trade', 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://drb.coinbase.com/api/v2/private/execute_block_trade",
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([
'id' => 1,
'jsonrpc' => '2.0',
'method' => 'private/execute_block_trade',
'params' => [
'counterparty_signature' => '1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI',
'nonce' => 'bszyprbq',
'role' => 'maker',
'timestamp' => 1590485535899,
'trades' => [
[
'amount' => 200000,
'direction' => 'sell',
'instrument_name' => 'BTC-PERPETUAL',
'price' => 8900
],
[
'amount' => 5,
'direction' => 'sell',
'instrument_name' => 'BTC-28MAY20-9000-C',
'price' => 0.0133
]
]
]
]),
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://drb.coinbase.com/api/v2/private/execute_block_trade"
payload := strings.NewReader("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\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://drb.coinbase.com/api/v2/private/execute_block_trade")
.header("Content-Type", "application/json")
.body("{\n \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://drb.coinbase.com/api/v2/private/execute_block_trade")
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 \"id\": 1,\n \"jsonrpc\": \"2.0\",\n \"method\": \"private/execute_block_trade\",\n \"params\": {\n \"counterparty_signature\": \"1590485595899.1Mn52L_Q.lNyNBzXXo-_QBT_wDuMgnhA7uS9tBqdQ5TLN6rxbuoAiQhyaJYGJrm5IV_9enp9niY_x8D60AJLm3yEKPUY1Dv3T0TW0n5-ADPpJF7Fpj0eVDZpZ6QCdX8snBWrSJ0TtqevnO64RCBlN1dIm2T70PP9dlhiqPDAUYI4fpB1vLYI\",\n \"nonce\": \"bszyprbq\",\n \"role\": \"maker\",\n \"timestamp\": 1590485535899,\n \"trades\": [\n {\n \"amount\": 200000,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-PERPETUAL\",\n \"price\": 8900\n },\n {\n \"amount\": 5,\n \"direction\": \"sell\",\n \"instrument_name\": \"BTC-28MAY20-9000-C\",\n \"price\": 0.0133\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "2.0",
"result": {
"id": "61",
"timestamp": 1565089523720,
"trades": [
{
"amount": 10,
"block_trade_id": "61",
"direction": "sell",
"fee": 0.00025,
"fee_currency": "BTC",
"index_price": 11738,
"instrument_name": "BTC-9AUG19-10250-C",
"iv": 0,
"liquidity": "T",
"matching_id": null,
"order_id": "343062",
"order_type": "limit",
"price": 0.0001,
"state": "filled",
"tick_direction": 3,
"timestamp": 1565089523719,
"trade_id": "92437",
"trade_seq": 37
},
{
"amount": 190,
"block_trade_id": "61",
"direction": "buy",
"fee": 0.00000164,
"fee_currency": "BTC",
"index_price": 11737.98,
"instrument_name": "BTC-PERPETUAL",
"liquidity": "T",
"matching_id": null,
"order_id": "343058",
"order_type": "limit",
"price": 11590,
"state": "filled",
"tick_direction": 3,
"timestamp": 1565089523719,
"trade_id": "92435",
"trade_seq": 25350
}
]
}
}Query Parameters
Timestamp, shared with other party (milliseconds since the UNIX epoch) The timestamp (milliseconds since the Unix epoch)
Example:
1536569522277
Nonce
Example:
"bF1_gfgcsd"
Describes if user wants to be maker or taker of trades
Trade role of the user: maker or taker
Available options:
maker, taker List of trades for block trade
Show child attributes
Show child attributes
Signature of block trade generated by private/verify_block_trade_method
Signature of block trade
It is valid only for 5 minutes around given timestamp
Example:
"1565173369982.1M9tO0Q-.z9n9WyZUU5op9pEz6Jtd2CI71QxQMMsCZAexnIfK9HQRT1pKH3clxeIbY7Bqm-yMcWIoE3IfCDPW5VEdiN-6oS0YkKUyXPD500MUf3ULKhfkmH81EZs"
Was this page helpful?
⌘I