cURL

curl --request GET \
  --url https://drb.coinbase.com/api/v2/private/get_transaction_log \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 4,
  "jsonrpc": "2.0",
  "method": "private/get_transaction_log",
  "params": {
    "count": 5,
    "currency": "BTC",
    "end_timestamp": "1613660407000",
    "start_timestamp": "1613657734000"
  }
}
'

import requests

url = "https://drb.coinbase.com/api/v2/private/get_transaction_log"

payload = {
    "id": 4,
    "jsonrpc": "2.0",
    "method": "private/get_transaction_log",
    "params": {
        "count": 5,
        "currency": "BTC",
        "end_timestamp": "1613660407000",
        "start_timestamp": "1613657734000"
    }
}
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: 4,
    jsonrpc: '2.0',
    method: 'private/get_transaction_log',
    params: {
      count: 5,
      currency: 'BTC',
      end_timestamp: '1613660407000',
      start_timestamp: '1613657734000'
    }
  })
};

fetch('https://drb.coinbase.com/api/v2/private/get_transaction_log', 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/get_transaction_log",
  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' => 4,
    'jsonrpc' => '2.0',
    'method' => 'private/get_transaction_log',
    'params' => [
        'count' => 5,
        'currency' => 'BTC',
        'end_timestamp' => '1613660407000',
        'start_timestamp' => '1613657734000'
    ]
  ]),
  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/get_transaction_log"

	payload := strings.NewReader("{\n  \"id\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\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/get_transaction_log")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://drb.coinbase.com/api/v2/private/get_transaction_log")

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\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\n  }\n}"

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

{
  "id": 4,
  "jsonrpc": "2.0",
  "result": {
    "continuation": 61282,
    "logs": [
      {
        "balance": 3001.22270418,
        "cashflow": -2.5,
        "change": -2.5,
        "commission": 0,
        "currency": "BTC",
        "equity": 3000.9275869,
        "id": 61312,
        "info": {
          "other_user": "Subaccount",
          "other_user_id": 27,
          "transfer_type": "subaccount"
        },
        "instrument_name": null,
        "interest_pl": null,
        "order_id": null,
        "position": null,
        "price": null,
        "side": "-",
        "timestamp": 1613659830333,
        "trade_id": null,
        "type": "transfer",
        "user_id": 7,
        "user_seq": 6009,
        "username": "TestUser"
      },
      {
        "amount": 1520,
        "balance": 3003.72270418,
        "cashflow": 0.00215706,
        "change": 0.00215706,
        "commission": null,
        "currency": "BTC",
        "equity": 3003.42821428,
        "id": 61311,
        "info": {
          "floating_pl": 0.00220172,
          "settlement_price": 51807
        },
        "instrument_name": "BTC-PERPETUAL",
        "interest_pl": 0.00000993,
        "order_id": null,
        "position": 1520,
        "price": 51807.07,
        "price_currency": "USD",
        "session_rpl": -0.00004467,
        "session_upl": 0.00220172,
        "side": "long",
        "timestamp": 1613659544153,
        "total_interest_pl": 0.00001243,
        "trade_id": null,
        "type": "settlement",
        "user_id": 7,
        "user_seq": 6008,
        "username": "TestUser"
      },
      {
        "balance": 3003.72054712,
        "cashflow": 0.65,
        "change": 0.65,
        "commission": 0,
        "currency": "BTC",
        "equity": 3003.4876111,
        "id": 61291,
        "info": {
          "addr": "2N8prMvpZHr8aYqodX3S4yhz5wMxjY8La3p",
          "deposit_type": "wallet",
          "transaction": "de6eba075855f32c9510f338d3ca0900376cedcb9f7b142caccfbdc292d3237e"
        },
        "instrument_name": null,
        "interest_pl": null,
        "order_id": null,
        "position": null,
        "price": null,
        "side": "-",
        "timestamp": 1613657828414,
        "trade_id": null,
        "type": "deposit",
        "user_id": 7,
        "user_seq": 6007,
        "username": "TestUser"
      },
      {
        "amount": 0.7,
        "balance": 3003.07054712,
        "cashflow": -0.10759,
        "change": -0.10759,
        "commission": 0,
        "currency": "BTC",
        "equity": 3002.83270455,
        "id": 61289,
        "info": "Source: api",
        "instrument_name": "BTC-19FEB21-49200-C",
        "interest_pl": 0,
        "ip": "11.222.33.44",
        "mark_price": 0.04884653215049635,
        "order_id": "67546",
        "position": 0.7,
        "price": 0.1537,
        "price_currency": "BTC",
        "profit_as_cashflow": false,
        "side": "open buy",
        "timestamp": 1613657734620,
        "trade_id": "28349",
        "type": "trade",
        "user_id": 7,
        "user_role": "maker",
        "user_seq": 6006,
        "username": "TestUser"
      },
      {
        "amount": 0.3,
        "balance": 3003.17813712,
        "cashflow": -0.04611,
        "change": -0.04611,
        "commission": 0,
        "currency": "BTC",
        "equity": 3002.83270455,
        "id": 61288,
        "info": "Source: api",
        "instrument_name": "BTC-19FEB21-49200-C",
        "interest_pl": 0,
        "mark_price": 0.04884653215049635,
        "order_id": "67546",
        "position": 0,
        "price": 0.1537,
        "price_currency": "BTC",
        "profit_as_cashflow": false,
        "side": "close buy",
        "timestamp": 1613657734620,
        "trade_id": "28349",
        "type": "trade",
        "user_id": 7,
        "user_role": "maker",
        "user_seq": 6005,
        "username": "TestUser"
      }
    ]
  }
}

Account Management

private/get_transaction_log

Retrieves a detailed transaction log for the authenticated account. The log includes all account activities such as trades, deposits, withdrawals, transfers, fees, and other balance-affecting operations.

Results can be filtered by currency, time range, and transaction type. Use the continuation parameter for pagination when retrieving large transaction histories. To retrieve transactions for a specific subaccount, use the subaccount_id parameter.

History Limit: This API method has no time limit - users can query transaction history back to account creation. Note that the CSV export feature available on the website is year-limited to 2023.

Note - This method has distinct API rate limiting requirements: Sustained rate: 1 request/second. For more information, see Rate Limits.

📖 Related Support Article: Transaction log

Scope: rat#view or wallet:transactions:read

Try in API console

GET

private

get_transaction_log

cURL

curl --request GET \
  --url https://drb.coinbase.com/api/v2/private/get_transaction_log \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 4,
  "jsonrpc": "2.0",
  "method": "private/get_transaction_log",
  "params": {
    "count": 5,
    "currency": "BTC",
    "end_timestamp": "1613660407000",
    "start_timestamp": "1613657734000"
  }
}
'

import requests

url = "https://drb.coinbase.com/api/v2/private/get_transaction_log"

payload = {
    "id": 4,
    "jsonrpc": "2.0",
    "method": "private/get_transaction_log",
    "params": {
        "count": 5,
        "currency": "BTC",
        "end_timestamp": "1613660407000",
        "start_timestamp": "1613657734000"
    }
}
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: 4,
    jsonrpc: '2.0',
    method: 'private/get_transaction_log',
    params: {
      count: 5,
      currency: 'BTC',
      end_timestamp: '1613660407000',
      start_timestamp: '1613657734000'
    }
  })
};

fetch('https://drb.coinbase.com/api/v2/private/get_transaction_log', 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/get_transaction_log",
  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' => 4,
    'jsonrpc' => '2.0',
    'method' => 'private/get_transaction_log',
    'params' => [
        'count' => 5,
        'currency' => 'BTC',
        'end_timestamp' => '1613660407000',
        'start_timestamp' => '1613657734000'
    ]
  ]),
  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/get_transaction_log"

	payload := strings.NewReader("{\n  \"id\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\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/get_transaction_log")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://drb.coinbase.com/api/v2/private/get_transaction_log")

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\": 4,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"count\": 5,\n    \"currency\": \"BTC\",\n    \"end_timestamp\": \"1613660407000\",\n    \"start_timestamp\": \"1613657734000\"\n  }\n}"

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

{
  "id": 4,
  "jsonrpc": "2.0",
  "result": {
    "continuation": 61282,
    "logs": [
      {
        "balance": 3001.22270418,
        "cashflow": -2.5,
        "change": -2.5,
        "commission": 0,
        "currency": "BTC",
        "equity": 3000.9275869,
        "id": 61312,
        "info": {
          "other_user": "Subaccount",
          "other_user_id": 27,
          "transfer_type": "subaccount"
        },
        "instrument_name": null,
        "interest_pl": null,
        "order_id": null,
        "position": null,
        "price": null,
        "side": "-",
        "timestamp": 1613659830333,
        "trade_id": null,
        "type": "transfer",
        "user_id": 7,
        "user_seq": 6009,
        "username": "TestUser"
      },
      {
        "amount": 1520,
        "balance": 3003.72270418,
        "cashflow": 0.00215706,
        "change": 0.00215706,
        "commission": null,
        "currency": "BTC",
        "equity": 3003.42821428,
        "id": 61311,
        "info": {
          "floating_pl": 0.00220172,
          "settlement_price": 51807
        },
        "instrument_name": "BTC-PERPETUAL",
        "interest_pl": 0.00000993,
        "order_id": null,
        "position": 1520,
        "price": 51807.07,
        "price_currency": "USD",
        "session_rpl": -0.00004467,
        "session_upl": 0.00220172,
        "side": "long",
        "timestamp": 1613659544153,
        "total_interest_pl": 0.00001243,
        "trade_id": null,
        "type": "settlement",
        "user_id": 7,
        "user_seq": 6008,
        "username": "TestUser"
      },
      {
        "balance": 3003.72054712,
        "cashflow": 0.65,
        "change": 0.65,
        "commission": 0,
        "currency": "BTC",
        "equity": 3003.4876111,
        "id": 61291,
        "info": {
          "addr": "2N8prMvpZHr8aYqodX3S4yhz5wMxjY8La3p",
          "deposit_type": "wallet",
          "transaction": "de6eba075855f32c9510f338d3ca0900376cedcb9f7b142caccfbdc292d3237e"
        },
        "instrument_name": null,
        "interest_pl": null,
        "order_id": null,
        "position": null,
        "price": null,
        "side": "-",
        "timestamp": 1613657828414,
        "trade_id": null,
        "type": "deposit",
        "user_id": 7,
        "user_seq": 6007,
        "username": "TestUser"
      },
      {
        "amount": 0.7,
        "balance": 3003.07054712,
        "cashflow": -0.10759,
        "change": -0.10759,
        "commission": 0,
        "currency": "BTC",
        "equity": 3002.83270455,
        "id": 61289,
        "info": "Source: api",
        "instrument_name": "BTC-19FEB21-49200-C",
        "interest_pl": 0,
        "ip": "11.222.33.44",
        "mark_price": 0.04884653215049635,
        "order_id": "67546",
        "position": 0.7,
        "price": 0.1537,
        "price_currency": "BTC",
        "profit_as_cashflow": false,
        "side": "open buy",
        "timestamp": 1613657734620,
        "trade_id": "28349",
        "type": "trade",
        "user_id": 7,
        "user_role": "maker",
        "user_seq": 6006,
        "username": "TestUser"
      },
      {
        "amount": 0.3,
        "balance": 3003.17813712,
        "cashflow": -0.04611,
        "change": -0.04611,
        "commission": 0,
        "currency": "BTC",
        "equity": 3002.83270455,
        "id": 61288,
        "info": "Source: api",
        "instrument_name": "BTC-19FEB21-49200-C",
        "interest_pl": 0,
        "mark_price": 0.04884653215049635,
        "order_id": "67546",
        "position": 0,
        "price": 0.1537,
        "price_currency": "BTC",
        "profit_as_cashflow": false,
        "side": "close buy",
        "timestamp": 1613657734620,
        "trade_id": "28349",
        "type": "trade",
        "user_id": 7,
        "user_role": "maker",
        "user_seq": 6005,
        "username": "TestUser"
      }
    ]
  }
}

Query Parameters

currency

enum<string>

required

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

Available options:

BTC,

ETH,

STETH,

ETHW,

USDC,

USDT,

EURR,

SOL,

XRP,

USYC,

PAXG,

BNB,

USDE

start_timestamp

integer

required

The earliest timestamp to return result from (milliseconds since the UNIX epoch) The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

end_timestamp

integer

required

The most recent timestamp to return result from (milliseconds since the UNIX epoch) The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

query

string

The following keywords can be used to filter the results: trade, maker, taker, open, close, liquidation, buy, sell, withdrawal, delivery, settlement, deposit, transfer, option, future, correction, block_trade, swap. Plus withdrawal or transfer addresses

Example:

"settlement"

count

integer

Count of transaction log entries returned, default - 100, maximum - 250

Required range: 1 <= x <= 250

subaccount_id

integer

Id of a subaccount

Example:

9

continuation

integer

Continuation token for pagination

Example:

429946

Response

200 - application/json

Success response

jsonrpc

enum<string>

required

The JSON-RPC version (2.0)

Available options:

2.0

result

object

required

Show child attributes

integer

The id that was sent in the request

private/get_positions

private/pme/simulate

⌘I

Get Started

Spot & US Derivatives - REST

Spot & US Derivatives - WS Streams

Int Derivatives - REST/WS (Soon)

Int Derivatives - WS Streams (Soon)

private/get_transaction_log

Query Parameters

Response