Struct TransactionLogRequest

pub struct TransactionLogRequest<'a> {
    pub account_type: Option<Cow<'a, str>>,
    pub category: Option<Category>,
    pub currency: Option<Cow<'a, str>>,
    pub base_coin: Option<Cow<'a, str>>,
    pub log_type: Option<Cow<'a, str>>,
    pub start_time: Option<u64>,
    pub end_time: Option<u64>,
    pub limit: Option<u32>,
}

Parameters for requesting transaction log data.

Used to construct a request to the /v5/account/transaction-log endpoint to retrieve historical transaction records, such as trades, fees, and funding. Bots use this to audit trading activity, calculate costs, and analyze performance in perpetual futures trading.

Fields

account_type: Option<Cow<'a, str>>

The account type to filter logs (e.g., “UNIFIED”, “SPOT”) (optional).

Optionally filters transactions by account type. If unset, data for all account types is returned. Bots should specify this to focus on specific account activities.

category: Option<Category>

The product category (e.g., Linear, Inverse) (optional).

Optionally filters transactions by instrument type. If unset, data for all categories is returned. Bots should specify this to analyze specific contract types.

currency: Option<Cow<'a, str>>

The currency to filter logs (e.g., “USDT”) (optional).

Optionally filters transactions by settlement currency. If unset, data for all currencies is returned. Bots should specify this for targeted financial analysis.

base_coin: Option<Cow<'a, str>>

The base coin to filter logs (e.g., “BTC”) (optional).

Optionally filters transactions by base asset. If unset, data for all base coins is returned. Bots should specify this to focus on specific trading pairs.

log_type: Option<Cow<'a, str>>

The transaction type to filter logs (e.g., “TRADE”, “FUNDING”) (optional).

Optionally filters transactions by type, such as trades or funding fees. If unset, all transaction types are returned. Bots should specify this to analyze specific activities.

start_time: Option<u64>

The start time for the transaction log (Unix timestamp in milliseconds) (optional).

Defines the beginning of the time range. Bots should set this to focus on a specific historical period, such as a trading session.

end_time: Option<u64>

The end time for the transaction log (Unix timestamp in milliseconds) (optional).

Defines the end of the time range. Bots should set this to limit data to a specific period, optimizing performance.

limit: Option<u32>

The maximum number of transaction records to return (optional).

Controls the number of records returned (e.g., max 50). Bots should set a reasonable limit to balance data completeness with performance.

Implementations

impl<'a> TransactionLogRequest<'a>

pub fn new( account_type: Option<&'a str>, category: Option<Category>, currency: Option<&'a str>, base_coin: Option<&'a str>, log_type: Option<&'a str>, start_time: Option<u64>, end_time: Option<u64>, limit: Option<u32>, ) -> Self

Constructs a new TransactionLog request with specified parameters.

Allows customization of the transaction log request. Bots should use this to specify the exact filters and time range to align with their analysis needs.

pub fn default() -> Self

Creates a default TransactionLog request.

Returns a request with all fields unset. Suitable for broad queries but should be customized for specific analysis needs in production.

Trait Implementations

impl<'a> Clone for TransactionLogRequest<'a>

fn clone(&self) -> TransactionLogRequest<'a>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Default for TransactionLogRequest<'a>

fn default() -> TransactionLogRequest<'a>

Returns the “default value” for a type.