A terminal based portfolio tracking, analysis and optimization tool implemented in Go. One screenshot is worth a thousand words:
Start the program by running:
portfolio start --profile <path-to-profile>
Portfolios are described using a YAML file. Here is an example:
cash:
value: 10000.00
allocation: 10
portfolios:
- portfolio: FAAMG
allocation: 90
holdings:
- symbol: FB
quantity: 715
allocation: 20
basis: 20000
watch: 230
- symbol: AAPL
quantity: 1172
allocation: 20
basis: 20000
watch: 100
- symbol: AMZN
quantity: 78
allocation: 20
basis: 20000
watch: 2800
- symbol: MSFT
quantity: 861
allocation: 20
basis: 20000
watch: 200
- symbol: GOOG
quantity: 56
allocation: 20
basis: 20000
watch: 1400
More examples can be found here.
Oftentimes, it is helpful to structure the overall portfolio into multiple sub-portfolios, possibly with different goals and strategies. Here is a sample configuration in the profile:
cash:
value: 10000.00
allocation: 10
portfolios:
- portfolio: Strategic
allocation: 50
holdings:
...
- portfolio: FAAMG
allocation: 40
holdings:
...
Notice that you may specify target allocations across different portfolios, as well as a cash allocation. When running Portfolio-go, press m or 0 to go to the profile homepage. Press 1 - 9 to switch between different portfolios. (This does mean that we support a maximum of 9 portfolios.)
Here is what the profile homepage may look like:
We track the major indices and markets, as well as key commodity prices. We view crypto currency as a viable asset class and track BTC and ETH in the market data section. Incidentally, the sample portfolio for Strategic Asset Allocation includes a 5% allocation for BTC:
Portfolio-go automatically calculates the performance and return characteristics of each of the portfolios. These are compared against a benchmark, currently the S&P 500 index.
The start date of the analysis is selected as either 10 years ago, or the inception date of the newest security in the portfolio, whichever is later. So, if you have a newly IPO'd stock in the portfolio, the length of the analysis period will be determined by its IPO date and greatly shortened.
We try to use the target allocation as the starting allocation of the portfolio at the beginning of the analysis period. If the target allocation is not specified, we use the actual current allocation instead. Note that this may greatly differ from your actual portfolio allocation in the past, depending on how your portfolio has evolved over time.
On the profile homepage, we calculate the performance and return of the entire profile, by merging all portfolios together and using the actual allocation as the starting allocation of the merged portfolio.
We use Yahoo Finance APIs to retrieve real-time market data. Most of the columns are pretty self-explanatory. You can specify an optional watch price for a ticker. When the market price is at or below the watch price, it gets highlighted in the portfolio viewer.
cash:
value: 10000.00
allocation: 10
portfolios:
- portfolio: FAAMG
allocation: 40
holdings:
- symbol: TSLA
watch: 350