Support for "closed positions earnings"

[RaffaeleBianc0]

Problem Statement
I sold some of my positions.
I would like to track the earnings/losses also on those - like Yahoo Finance shows in my overall portfolio stats.

Proposed Solution
Open / Closed / All earnings on the top of the page would be great, maybe optional, maybe on multiple lines.
This could be even further improved, with additional (optional) values like earnings/year, net earnings (considering a tax on withdrawals), net earnings/year.
For us users, this could be a new set of parameters in the YAML configuration file, like:

<usual general options here>
<usual general options here>
<usual general options here>
tax: 26%                    # this is to be used to calculate the net earnings; no impact on losses; if missing, then no tax calculation needed
starting-date: 2024-08-21   # this is used for the earnings/year and net earnings/year values
show-earnings: true         # this is to add 1 or 2 more lines on the topmost area, to show the new calculated values
groups:
  - name: My ETF Portfolio
    holdings:  
      - <as usual here>
      - <as usual here>
      - <as usual here>
    closed:                                   # new group, to be used only if I want the earnings calculation this issue is suggesting
      - name: VWCE as suggested by Bob        # Any text string supported here, no need to be a ticker
        balance: 1234.56                      # Positive numbers for earnings
      - name: Bitcoins i bought while drunk   # Any text string supported here
        balance: -543.21                      # Negative numbers for losses

[achannarasappa]

Thank you for the suggestion! Adding the ability to represent realized PnL for closed positions seems like a good extension of existing position tracking features. I'll need to put some thought into how to expose this. Two approaches I'm considering with some initial thoughts:

1. User-defined realized PnL (what's proposed in this issue)
   • Pros
     • Simple to understand as a user
     • Many brokerages expose portfolio-wide realized PnL
     • Simple to implement
   • Cons
     • Mapping PnL to multiple groups may be tedious for users
     • Less extensible to automatic calculation in the future
2. Calculated realized PnL
   • Pros
     • Realized PnL is automatically calculated based off of transaction/trade history. Users only need to append new trades (quantity, trade price, symbol) as they happen. Similar data model to lots can be reused
     • Easier to import from an external system since similar data model to what tax and trading systems expose in export files
   • Cons
     • More complex to implement and may required breaking changes to the config file
     • Transaction history cardinality could be high and warrant separating out from the main ticker config file

Open to input and thoughts on approach and the usability of each.

Re: tax features such as tax rate and tax year, I think this is outside the scope of ticker but I would be open to reconsidering if there's significant community interest. Taxes are generally a function of the country where they applicable and adding support for tax-related features would mean embedding the relevant parts of a countries tax rules into ticker which I'd be concerned about.

[github-actions]

This issue is stale because it has been open 180 days with no activity. Remove stale label or comment or this will be closed in 60 days.