Struct CashTransaction

Source

pub struct CashTransaction {Show 46 fields
    pub account_id: String,
    pub transaction_id: Option<String>,
    pub transaction_type: Option<String>,
    pub description: Option<String>,
    pub amount: Decimal,
    pub currency: String,
    pub fx_rate_to_base: Option<Decimal>,
    pub date: Option<NaiveDate>,
    pub settle_date: Option<NaiveDate>,
    pub ex_date: Option<NaiveDate>,
    pub conid: Option<String>,
    pub symbol: Option<String>,
    pub asset_category: Option<AssetCategory>,
    pub cusip: Option<String>,
    pub isin: Option<String>,
    pub figi: Option<String>,
    pub security_id: Option<String>,
    pub security_id_type: Option<String>,
    pub multiplier: Option<Decimal>,
    pub strike: Option<Decimal>,
    pub expiry: Option<NaiveDate>,
    pub put_call: Option<PutCall>,
    pub underlying_conid: Option<String>,
    pub underlying_symbol: Option<String>,
    pub code: Option<String>,
    pub date_time: Option<String>,
    pub report_date: Option<NaiveDate>,
    pub available_for_trading_date: Option<NaiveDate>,
    pub action_id: Option<String>,
    pub trade_id: Option<String>,
    pub client_reference: Option<String>,
    pub issuer: Option<String>,
    pub issuer_country_code: Option<String>,
    pub sub_category: Option<String>,
    pub listing_exchange: Option<String>,
    pub underlying_listing_exchange: Option<String>,
    pub underlying_security_id: Option<String>,
    pub principal_adjust_factor: Option<Decimal>,
    pub serial_number: Option<String>,
    pub delivery_type: Option<String>,
    pub commodity_type: Option<String>,
    pub fineness: Option<Decimal>,
    pub weight: Option<String>,
    pub level_of_detail: Option<String>,
    pub model: Option<String>,
    pub acct_alias: Option<String>,
}

Expand description

A cash transaction (deposit, withdrawal, dividend, interest, fee)

Represents any cash flow that affects your account balance: deposits, withdrawals, dividends, interest payments, withholding taxes, and fees. Fields are organized into CORE and EXTENDED sections.

§Example

use ib_flex::parse_activity_flex;
use rust_decimal::Decimal;

let xml = std::fs::read_to_string("activity.xml")?;
let statement = parse_activity_flex(&xml)?;

// Categorize cash flows
let mut dividends = Decimal::ZERO;
let mut interest = Decimal::ZERO;
let mut fees = Decimal::ZERO;

for cash_txn in &statement.cash_transactions.items {
    match cash_txn.transaction_type.as_deref() {
        Some("Dividends") => {
            dividends += cash_txn.amount;
            println!("Dividend from {}: {}",
                cash_txn.symbol.as_ref().unwrap_or(&"N/A".to_string()),
                cash_txn.amount
            );
        }
        Some("Broker Interest Paid") | Some("Broker Interest Received") => {
            interest += cash_txn.amount;
        }
        Some("Other Fees") | Some("Commission Adjustments") => {
            fees += cash_txn.amount;
        }
        _ => {
            println!("{:?}: {}", cash_txn.transaction_type, cash_txn.amount);
        }
    }
}

println!("\nTotals:");
println!("  Dividends: {}", dividends);
println!("  Interest: {}", interest);
println!("  Fees: {}", fees);