Sign in

v3

latestOpenAPI 3.0.02026-07-311784111.3 MB
Account Management
Private

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.

📖 Related Support Article: Transaction log

Scope: account:read

Try in API console

get/private/get_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"

The currency symbol

start_timestampinteger required

The timestamp (milliseconds since the Unix epoch)

Example:1536569522277

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

end_timestampinteger required

The timestamp (milliseconds since the Unix epoch)

Example:1536569522277

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

querystring
Example:settlement

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, expiry. Plus withdrawal or transfer addresses

countinteger

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

subaccount_idinteger
Example:9

Id of a subaccount

continuationinteger
Example:429946

Continuation token for pagination

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "continuation": 429946,
    "logs": [
      {
        "id": 5967413,
        "timestamp": 1536569522277,
        "user_id": 57874,
        "username": "MrTrader",
        "instrument_name": "BTC-PERPETUAL",
        "order_id": "ETH-100234",
        "starbase_order_id": 103148386170,
        "starbase_timestamp": 1536569522277000000,
        "session_rpl": 0.1,
        "session_upl": 0.846863
      }
    ]
  }
}