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.
The summary
Section titled “The summary”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).
Grouping
Section titled “Grouping”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.
The columns
Section titled “The columns”| 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
commoditydirective, if it has anamemetadata. - 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.
“no price”
Section titled ““no price””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 EURAn old price is still a price: check the date under it to know how fresh the valuation is.
When a group shows no totals
Section titled “When a group shows no totals”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.
Jump to the purchase
Section titled “Jump to the purchase”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.
How it adds up
Section titled “How it adds up”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.