Skip to content

📝 Transaction Form

The Transaction Form opens whenever you create or edit a transaction. It adapts dynamically to the selected transaction type, showing only the fields relevant to that operation.

Buy Sell Dividend Deposit Adjustment Asset Transfer FX Conversion Cash Transfer

📋 The Form Interface

The form is designed to be intuitive and dynamic. When you select a Transaction Type, the form automatically adjusts to show only the relevant fields.

  • Basic Details: Date, Type, Currency, and Amount.
  • Asset Specifics: If the transaction involves an asset (like BUY or SELL), fields for selecting the asset, entering the quantity, and setting the unit price will appear.
  • Preview Panel (WAC): For operations that affect your portfolio, a real-time preview appears at the bottom. It shows your current cost basis, the projected new cost basis, and any realized gain/loss.

Automatic Calculations

The system automatically handles standard calculations for you (such as multiplying quantity by unit price) so you don't have to do the math manually.

🏷️ Transaction Types

For an in-depth conceptual definition of each operation, please refer to the Financial Theory guide.

Single Transactions

These operate independently on a single broker account.

Type Description Theory Guide
BUY / SELL Purchase or sale of an asset 📖 Read
DEPOSIT / WITHDRAWAL Adding or removing cash from a broker account 📖 Read
DIVIDEND / INTEREST Yield from equity or fixed-income assets 📖 Read
FEE / TAX Costs like broker fees or taxes 📖 Read
ADJUSTMENT Manual correction to balances 📖 Read

Composite Transactions

These represent movements between accounts or currencies. They produce two linked entries that balance each other.

Type Description Theory Guide
TRANSFER Asset moved between two of your brokers 📖 Read
CASH_TRANSFER Wire transfer between brokers 📖 Read
FX_CONVERSION Currency exchange within a broker 📖 Read

To maintain data integrity and enable advanced analytics, composite transactions group multiple cash and asset legs:

  • Asset Transfer: Specifies a source broker and a destination broker, asset, and quantity.
  • FX Conversion: Specifies the source currency amount and the destination currency amount within the same broker.

You can create composite transactions directly from the form, or by Promoting single transactions (like linking a deposit and a withdrawal) from the transaction table. If needed, a composite transaction can be split back into individual single transactions.