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.

🏷️ Transaction Types

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

Buy Sell Dividend Deposit Adjustment Asset Transfer FX Conversion Cash Transfer

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

📋 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.

💡 Note: 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.

🔄 Composite Transactions

TRANSFER and FX_CONVERSION are composite — they link two legs:

  • TRANSFER: specifies a source broker and a destination broker, plus the asset and quantity. LibreFolio records both legs atomically.
  • FX_CONVERSION: specifies the source currency amount and the destination currency amount within the same broker.

To split a composite back into two independent transactions, use the Split operation on the transaction table.