---
title: "GET /private/get_transaction_log"
method: GET
path: "/private/get_transaction_log"
tags: ["Account Management", "Private"]
---

# GET /private/get_transaction_log

`GET /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.

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.

**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](https://support.deribit.com/hc/en-us/articles/25944617523357-Rate-Limits).

**📖 Related Support Article:** [Transaction log](https://support.deribit.com/hc/en-us/articles/25944587269021-Transaction-log)

**Scope:** `account:read`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_transaction_log)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'STETH' | 'ETHW' | 'USDC' | 'USDT' | 'EURR' | 'SOL' | 'XRP' | 'USYC' | 'PAXG' | 'BNB' | 'USDE', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `start_timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
- `end_timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
- `query` string
- `count` integer
- `subaccount_id` integer
- `continuation` integer

## Response `200`

Success response

- PrivateGetTransactionLogResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `continuation` integer, required — Continuation token for pagination. `NULL` when no continuation.
    - `logs` TransactionLog[], required
      - `id` integer, required — Unique identifier
      - `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
      - `timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
      - `user_id` integer, required — Unique user identifier
      - `username` string — System name or user defined subaccount alias
      - `commission` number, required — Commission paid so far (in base currency)
      - `cashflow` number, required — For futures and perpetual contracts: Realized session PNL (since last settlement). For options: the amount paid or received for the options traded.
      - `balance` number, required — Cash balance after the transaction
      - `change` number, required — Change in cash balance. For trades: fees and options premium paid/received. For settlement: Futures session PNL and perpetual session funding.
      - `user_seq` integer, required — Sequential identifier of user transaction
      - `type` string, required — Transaction category/type. The most common are: `trade`, `deposit`, `withdrawal`, `settlement`, `delivery`, `transfer`, `swap`, `correction`, `expiry`. New types can be added any time in the future
      - `info` object — Additional information regarding transaction. Strongly dependent on the log entry type
      - `equity` number — Updated equity value after the transaction
      - `mark_price` number — Market price during the trade
      - `settlement_price` number — The settlement price for the instrument during the delivery
      - `index_price` number — The index price for the instrument during the delivery
      - `instrument_name` string — Unique instrument identifier
      - `position` number — Updated position size after the transaction
      - `side` string — One of: `short` or `long` in case of settlements, `close sell` or `close buy` in case of deliveries, `open sell`, `open buy`, `close sell`, `close buy` in case of trades
      - `amount` number — It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.
      - `price` number — Settlement/delivery price or the price level of the traded contracts
      - `price_currency` string — Currency symbol associated with the `price` field value
      - `trade_id` string — Unique (per currency) trade identifier
      - `order_id` string — Unique order identifier
      - `user_role` 'maker' | 'taker' — Trade role of the user: `maker` or `taker`
      - `fee_role` 'maker' | 'taker' — Fee role of the user: `maker` or `taker`. Can be different from trade role of the user when iceberg order was involved in matching.
      - `profit_as_cashflow` boolean — Indicator informing whether the cashflow is waiting for settlement or not
      - `interest_pl` number — Actual funding rate of trades and settlements on perpetual instruments
      - `block_rfq_id` integer — ID of the Block RFQ - when trade was part of the Block RFQ
      - `ip` string — The IP address from which the trade was initiated
      - `starbase_match_id` integer — Starbase match id for trades executed in Starbase
      - `starbase_order_id` integer — Starbase order id for orders placed in Starbase
      - `starbase_timestamp` integer — The Starbase causal timestamp of the trade (nanoseconds since the Unix epoch)
      - `session_rpl` number — Session realized profit and loss
      - `session_upl` number — Session unrealized profit and loss
      - `total_interest_pl` number — Total session funding rate
      - `contracts` number — It represents the order size in contract units. (Optional, may be absent in historical data).

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)