Skip to content

🔍 Positions & Analysis

⬅️ Back to Dashboard Overview

The Positions tab of the dashboard allows you to inspect open holdings, analyze performance, and drill down into matching tax lots.

Holdings Table View Holdings Map View Performance Table View Performance Map View

🔍 Positions Tab

The Positions tab provides a detailed breakdown of all the financial instruments currently held in your portfolio (Stocks, ETFs, Bonds, Cryptocurrencies, etc.).

The Positions tab allows you to switch between two primary metric modes using the view toggle, each focusing on a different aspect of your holdings:

📋 Holdings View

The Holdings view focuses on bookkeeping, quantities, and current asset valuation. It helps you monitor your current portfolio exposure and baseline metrics.

Metric Description
Quantity Current shares, units, or coins held in your portfolio.
Market Price Live asset price retrieved from the connected data provider.
Market Value Total value at current market prices (\(\text{Price} \times \text{Quantity}\)).
Average Price (WAC) The Weighted Average Cost paid to acquire the current open position.
Weight Proportional share of this asset relative to the total portfolio value.

📈 Performance View

The Performance view focuses on absolute and relative returns. It helps you analyze the profitability of your open positions, factoring in historical transactions and income.

Metric Description
Total Value Current value of the holdings (matches Market Value).
Unrealized P&L Paper gain or loss calculated as \(\text{Market Value} - \text{Book Value}\).
ROI % Rate of return relative to the cost basis of the position.
Total P&L Cumulative absolute returns (includes past closed sales & dividends).

🗺️ Visual Style: Table vs. Map

Visual Mode Core Features Optimal Use Case
📋 Table View • Sortable grid layout
• Precise numerical values
• Quick column sorting		 Standard bookkeeping, searching specific asset quantities, or comparing WAC values.
🗺️ Map View • Visual Treemap visualization
• Size indicates asset weight
• Color intensity indicates performance (green = gain, red = loss)		 Quick visual diagnostics, spotting over-allocation, or identifying underperforming assets.

🔬 FIFO Lots Analysis

When you click on a position in either Table or Map view, LibreFolio expands an inline FIFO Lots Analysis panel directly below the Positions view. It uses a vertical slide transition and scrolls into view automatically — it is not a right-side slide-over. If needed, a data-quality banner appears first, then the analysis blocks stay in this order: WAC / Market Price, Lot Life & Custody, unified lots table, Value / Return comparison, and the lot detail modal. By default, no explicit selection means all currently visible lots are included across the linked charts.

FIFO Lots Analysis Overview WAC and Market Price Chart Lot Life and Custody Gantt Chart Unified Lots Table Value Comparison Chart Return Comparison Chart Lot Detail Modal

1. WAC / Market Price

This first chart compares the asset's Market Price with the per-broker WAC lines and the combined WAC line for the selected position.

  • Toggle ABS / % to switch between absolute prices and percentage evolution from the range start.
  • In ABS mode, toggle Auto / From 0 to choose whether the Y axis is tightly fitted or forced to start at zero.
  • Event markers and lot-performance bubbles help you connect buys, sells, transfers, splits, and income events to the cost basis history.
  • Clicking lot bubbles updates the shared lot selection used by the other blocks.
  • Bubble color matches the lot's opening broker — the same colors used by the custody bars in block 2 below.
  • Bubble size reflects the lot's opening value (its original cost basis): larger bubbles started as larger investments.
  • A dashed bubble border marks a lot currently shown at cost because no live market price is available for it yet.

🔗 Theory: Refer to Weighted Average Cost (WAC) for cost-basis rules, and Valuation Price Chain for how market prices are resolved.

2. Lot Life & Custody

The Lot life & custody block is a Gantt-style timeline showing when each lot was open and where it was held over time.

  • Use the Open / Closed filter to show only open lots, only closed lots, or both.
  • Each bar represents a lot's life; transfers create extra custody lanes so you can see broker-to-broker moves and in-transit periods.
  • Bar color identifies the custody broker currently holding that segment of the lot — matching broker badges are listed in the legend below the chart. A dashed violet segment marks a period in transit between brokers (transfer initiated but not yet arrived).
  • Bar thickness is proportional to the quantity held during that exact segment — a lot that was partially sold or split shows thinner bars afterward.
  • Clicking a bar selects that lot across the shared analysis; double-clicking can jump back to the matching row in the table.

🔗 Theory: See FIFO Engine — Lot Lifecycle & Matching Model for how lot states, splits, and transfers between brokers are defined.

3. Unified Lots Table

v3 replaces the old split Open Lots and Closed Lots tables with one unified table.

  • The table shows the current lot set with columns such as opening date, total return, current value, custody, and Status.
  • Shared filtering means the table always reflects the same visible lot set as the charts above.
  • Each row's Actions menu includes:
    • View lot detail
    • Go to lot in Gantt
    • Go to opening transaction
    • Copy lot identifier

4. Value / Return Comparison

This comparison chart focuses on the lots currently selected in the panel. If you have not selected specific lots, it uses all visible lots.

  • Switch between Value and Return using the top-right mode toggle.
  • Value mode compares the selected lots in absolute money terms and also offers the Auto / From 0 Y-axis toggle.
  • Return mode compares percentage return from each lot's opening date across the same selected lot set.

5. Lot Detail Modal

Choose View lot detail from the table row actions to open the FIFO Lot Detail modal for a specific lot.

  • The summary includes Total P&L, Total return, Asset income, Cash yield, FIFO P&L, opening/current value, and other lot-level metrics.
  • Current Custody shows how the lot is currently distributed across brokers or in-transit slices.
  • History lists the full custody and lifecycle chronology, including transfers and other lot events, with a direct Go to transaction action for the relevant transaction.

FIFO matching logic

LibreFolio resolves lot closures strictly with First-In, First-Out (FIFO) matching: sell quantities always consume the oldest eligible open lot first before newer lots are touched.

For deeper theory and formulas, see:

💸 Transactions Tab

The Transactions tab on the Dashboard displays a complete, paginated list of all operations recorded across the active portfolio scope (buy/sell orders, dividend payouts, cash deposits, transfers, etc.).

For a detailed explanation of the transaction list, filters, and how to read the read-only transaction details, please refer to the dedicated Transactions Overview page.