cURL

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

import requests

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

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

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

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

require 'uri'
require 'net/http'

url = URI("https://test.deribit.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  \"jsonrpc\": \"2.0\",\n  \"id\": 4,\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"start_timestamp\": \"1613657734000\",\n    \"end_timestamp\": \"1613660407000\",\n    \"count\": 5\n  }\n}"

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

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

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 query keywords. start_timestamp must not exceed end_timestamp; both values are clamped to the current time, so a future end_timestamp is treated as now. The matching window includes end_timestamp.

count defaults to 100 and is capped at 1000. Pass continuation (a log id from the previous response) to fetch the next older page. continuation is null when there are no more entries.

To retrieve transactions for a specific subaccount, pass subaccount_id from the main account. Removed subaccounts are accepted. The authenticated user id is always applied as a filter.

Trade entries executed in Starbase include starbase_match_id, starbase_order_id, and starbase_timestamp. Those fields are omitted on spot trades. Block RFQ allocations appear as type trade allocation rather than trade.

When an option expires out of the money, the transaction log type is expiry. As there is nothing to settle into futures in this case, this remains the only entry in the transaction log for that expiration. In-the-money expiries use assignment or exercise, and may be followed by a future creation entry.

LSP and ADL position moves are logged as type LSP transfer / ADL transfer. Both the liquidated/deleveraged account and the receiving account get that same type. A separate optional role field (source or destination) is present on those transfer entries — and also on liquidation transfer and position move — and is omitted on all other types, including LSP commission / ADL commission and ordinary trades. Do not confuse role with user_role (maker / taker) on trades.

Correction entries may include a related array of the original log entries they correct. While the platform is starting, the method may return temporarily_unavailable.

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

📖 Related Article: Liquidity Support Program (LSP) API Guide

Scope: account:read

Try in API console

cURL

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

import requests

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

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

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

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

require 'uri'
require 'net/http'

url = URI("https://test.deribit.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  \"jsonrpc\": \"2.0\",\n  \"id\": 4,\n  \"method\": \"private/get_transaction_log\",\n  \"params\": {\n    \"currency\": \"BTC\",\n    \"start_timestamp\": \"1613657734000\",\n    \"end_timestamp\": \"1613660407000\",\n    \"count\": 5\n  }\n}"

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

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

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,

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

Space-separated keywords used to filter results. An entry must match every keyword. Keywords are case-sensitive.

Transaction types:

trade - trades
deposit - deposits
withdrawal - withdrawals
transfer - transfers between accounts
reward - reward transfers
mm_lsp_payment - market-maker LSP payout transfers
settlement - funding / session settlement (display type settlement)
delivery - instrument delivery (display type delivery)
expiry - options that expired out of the money
assignment - assigned options
exercise - exercised options
swap - currency swaps
correction - balance corrections
block_trade - block trades
combo_trade - combo trades
liquidation - liquidation trades and liquidation transfers (display type liquidation transfer)
lsp - LSP position moves and commissions (display types LSP transfer / LSP commission)
adl - ADL position moves and commissions (display types ADL transfer / ADL commission)
commission - LSP/ADL commissions; typically combined with lsp or adl
position - position moves (display type position move); also matches position move transfer
insurance - insurance-related transfers
insurance_transfer - insurance transfers
affiliate - affiliate payouts
partner - partner / application fee payouts
fee_deposit - fee balance deposits
fee_balance_transfer - fee balance transfers
stake_reward - staking rewards
lock_deposit_balance - locked deposit balance
unlock_deposit_balance - unlocked deposit balance
summary - settlement summaries
options_settlement_summary - options settlement summaries
negative_balance_fee - negative balance fees
creation - future creation from expired options (display type future creation)
margin_loan - margin loan interest, issuance, and repayment
corporate_action_adjustment - stock split, rights offering, and spin-off adjustments
stock_split - stock splits
rights_offering - rights offerings
spin_off - spin-offs
m_and_a - mergers and acquisitions (display type m&a)
rename - instrument renames
custody_settlement_fee - custody settlement fees
sweep_isolated_position - isolated position sweeps
structured_product_spread - structured product spread
usdc_reward - USDC rewards
usdc_reward_received - USDC rewards received
usdc_platform_reward - USDC platform rewards
usdc_reward_payment - USDC reward payments
ethena_reward - Ethena rewards
buidl_reward - BUIDL rewards
socialize_loses - socialized losses/refunds (display types socialized fund / socialized refund)

Additional filters:

maker / taker - trade role
open / close - trade kind (close also matches deliveries and liquidations)
buy / sell - direction
option / future / spot - instrument kind
voice_broker - voice-broker trades

Additional indexed values, depending on type:

deposits — destination address (custody deposits also index custody name and request id)
withdrawals — withdrawal code or custody request id (not the destination address)
transfers — counterparty username

Example:

"settlement"

count

integer

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

Required range: 1 <= x <= 1000

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

Hide child attributes

result.continuation

integer

required

Continuation token for pagination. NULL when no continuation.

Example:

429946

result.logs

object[]

required

Hide child attributes

result.logs.id

integer

required

Unique identifier

Example:

5967413

result.logs.currency

enum<string>

required

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

Available options:

BTC,

ETH,

USDC,

USDT,

EURR

result.logs.timestamp

integer

required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result.logs.user_id

integer

required

Unique user identifier

Example:

57874

result.logs.commission

number

required

Commission paid so far (in base currency)

result.logs.cashflow

number

required

Signed cash-related amount for this entry, in the log currency. Meaning depends on type and instrument kind: deposits/withdrawals/transfers use the moved amount; option trades use premium paid/received; future trades use realized session PnL when profit_as_cashflow is true, otherwise the cash movement. Do not assume it always equals change.

result.logs.balance

number

required

Cash balance after the transaction

result.logs.change

number

required

Change in cash balance for this entry. When the platform recorded an explicit balance change, that value is used; otherwise cashflow - commission. On future trades with profit_as_cashflow true, session PnL sits in cashflow and change reflects the cash-balance movement (typically fees).

result.logs.user_seq

integer | null

required

Sequential identifier of user transaction in this currency. null on entries that were not assigned a sequence (common for some non-trade types).

result.logs.type

string

required

Transaction category. Present on every log entry. New types can be added at any time.

Common values include trade, deposit, withdrawal, settlement, delivery, transfer, swap, correction, expiry, assignment, exercise, future creation, LSP transfer, LSP commission, ADL transfer, ADL commission. Block RFQ allocations use trade allocation rather than trade.

Display values are not always the same as query keywords (for example query lsp to match LSP transfer). See the query parameter.

type is not a substitute for role: both sides of an LSP or ADL position move use the same type (LSP transfer or ADL transfer). Which side this entry is on is role, when that field is present.

result.logs.username

string

System name or user defined subaccount alias

Example:

"MrTrader"

result.logs.role

enum<string>

Which side of a position move this log entry represents: source (the account the position is taken from) or destination (the account receiving the position).

Present only on LSP transfer, ADL transfer, liquidation transfer, and position move entries. Omitted on every other type, including LSP commission, ADL commission, trade, settlement, and transfer. Not the same as user_role (maker / taker) on trade entries.

Websocket liquidation notifications do not use this field; they distinguish sides with state (lsp_transfer / adl_transfer vs adl_transfer_received).

Available options:

source,

destination

result.logs.info

any

Additional information. Shape depends on type:

trades: a string such as Source: api or Source: voice_broker (not an object)
transfers and similar: an object (counterparties, transfer_type, ...)
null when there is nothing extra

Present on correction entries. The original log entries this correction applies to.

result.logs.fee_balance

number

The account's fee balance (it can be used to pay for fees)

result.logs.equity

number

Updated equity value after the transaction

result.logs.mark_price

number

Market price during the trade

result.logs.settlement_price

number

The settlement price for the instrument during the delivery

result.logs.index_price

number

Index price associated with the entry when recorded. Present on deliveries and also on some trades, deposits, withdrawals, and transfers. Omitted when the log has no index price.

result.logs.instrument_name

string

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.logs.position

number

Updated position size after the transaction

result.logs.side

string

Directional label. Value depends on type:

trades: open buy, open sell, close buy, close sell (liquidation trades use liquidation buy / liquidation sell)
deliveries / exercise: close buy or close sell
settlements: long, short, or - when size is zero
position moves: buy or sell when a direction is set
entries with no side: -

result.logs.amount

number

Size of the activity when the entry is instrument-related. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin. For spot trades it is the cash amount. 0 or omitted on entries with no size (for example a settlement with a flat position).

result.logs.price

number

Settlement/delivery price or the price level of the traded contracts

result.logs.price_currency

string

Currency symbol associated with the price field value

result.logs.trade_id

string

Unique (per currency) trade identifier

result.logs.order_id

string

Unique order identifier

Example:

"ETH-100234"

result.logs.user_role

enum<string>

Trade role of the user: maker or taker

Available options:

maker,

taker

result.logs.fee_role

enum<string>

Fee role of the user: maker or taker. Can be different from trade role of the user when iceberg order was involved in matching.

Available options:

maker,

taker

result.logs.profit_as_cashflow

boolean

Present on trades. true on future trades when realized session PnL is carried in cashflow and has not yet been settled into the cash balance. false on option and spot trades, and on future trades with no PnL in cashflow.

result.logs.interest_pl

number

Funding PnL amount for the interval between this log entry and the previous trade or position change on perpetual instruments

result.logs.block_rfq_id

integer

ID of the Block RFQ - when trade was part of the Block RFQ

result.logs.ip

string

The IP address from which the trade was initiated

result.logs.starbase_match_id

integer

Starbase match id for trade entries executed in Starbase. Omitted on spot trades and on Thunder-only trades.

result.logs.starbase_order_id

integer

Raw Starbase order id for trade entries associated with orders placed in Starbase. Omitted on spot trades and when the order was not placed in Starbase.

Example:

103148386170

result.logs.starbase_timestamp

integer

Starbase causal timestamp for trade entries executed in Starbase. Omitted on spot trades and on Thunder-only trades.

Example:

1536569522277000000

result.logs.session_rpl

number

Realized profit and loss accrued in the current trading session (since the last daily settlement). Resets at each daily settlement.

Example:

0.1

result.logs.session_upl

number

Unrealized profit and loss on open positions in the current trading session (since the last daily settlement).

Example:

0.846863

result.logs.total_interest_pl

number

Total funding PnL accrued in the current trading session since the last daily settlement at 08:00 UTC, in the settlement currency. Resets at each daily settlement.

result.logs.contracts

number

It represents the order size in contract units. (Optional, may be absent in historical data).

integer

The id that was sent in the request

Methods overview

Methods

private/get_transaction_log

Query Parameters

Response