Skip to content

Holdings

Portfolio (⌘4) shows what you hold and at what cost, lot by lot, on the last day of the period. The subtitle says which day: As of 31 Mar 2026. To see your portfolio as it was at the end of last year, choose Last Year.

A lot is one purchase that you still hold (all or part of it): an account, a commodity, a cost and a date. Buy the same fund three times and you have three lots.

Portfolio is not affected by filters. It lists positions, not transactions.

Above the table, three headline figures and the number of positions:

Figure Meaning
Market Value What it is all worth at the prices of that day.
Book Value What you paid for it.
Unrealized Gain The difference, as an amount and a percentage, with an arrow ↗ or ↘.

The summary always describes what is listed: only the positions held at cost normally, or all your assets when Cash is on (book value and gain still refer to the positions held at cost).

The segmented control in the toolbar chooses how lots are arranged:

Option What you see
By Commodity (default) One row per investment with its totals, and its lots underneath, by purchase date.
By Account The same, grouped by the account that holds them.
All Lots A flat list of every lot.

Click the triangle of a group to show or hide its lots.

Column In a group row In a lot row
Holding Name of the commodity (and its ticker) or account. The purchase date, and the account.
Units Total units. Units of that lot.
Cost Average cost per unit (marked average). What each unit of this lot cost.
Book Value Units × cost: what you paid. The same, for the lot.
Price Latest price on or before the date, and the date of that price beneath it. The same.
Market Value Units × price. The same.
Unrealized Gain Market value − book value, and the percentage. The same.
  • The name of a commodity comes from its commodity directive, if it has a name metadata.
  • Unit costs and prices keep all their decimals; amounts use the precision of their currency.
  • Gains carry a sign and an arrow; green and red only reinforce it.

If the ledger has no price for a commodity on or before the date, its Price cell says no price, the lot is valued at cost, and no gain is shown for it. Add a price in the editor:

2026-03-31 price VWCE 118.42 EUR

An old price is still a price: check the date under it to know how fresh the valuation is.

If a group is showing only some of its lots — for example By Account, for an account that holds both cash and shares, with Cash off — its totals are left blank. The totals would describe more than what you see.

The Cash toggle (a banknote) adds the positions without a cost basis: bank balances, cash, anything you did not “buy”. It is off by default, so the screen is about investments.

With it on, Portfolio lists all your Assets and the summary’s Market Value matches the Assets of the Balance Sheet at market value. A position without cost is worth its own units and has no gain.

If the period ends on a day when nothing was held at cost, the screen says so and offers Show Cash Positions.

Double-click a lot, or right-click it and choose Reveal Purchase in Editor, to open the editor on the transaction that bought it. The app looks for it in the whole ledger, not just in the period.

Portfolio reconciles with the Balance Sheet at the same date:

  • The sum of Units equals Assets shown in Units.
  • The sum of Book Value equals Assets At Cost.
  • The sum of Market Value equals Assets at Market Value.

Which lots remain after a sale is decided by Beancount’s booking method for the account (FIFO, for instance): buy 10 at 100 and 5 at 110, sell 4, and the lots left are 6 and 5.