PortfolioOverlap

PortfolioOverlap is a CLI tool that helps you to compare the weighted holdings of your stock portfolio with popular Exchange Traded Funds (ETFs) to distinguish overlaps. It also features the resolution of ETFs into their individual components to help you to understand the underlying components of the ETF and find possible risk concentrations.

Currently, 4 ETFs of ARK Invest are supported:

ETF	Ticker
ARK INNOVATION ETF	ARKK
ARK Autonomous Technology & Robotics ETF	ARKQ
ARK Next Generation Internet ETF	ARKW
ARK Genomic Revolution ETF	ARKG

Installation

The Python virtualenv is recommended to use as a Python environment. This project requires Python3.

git clone https://github.com/IV1T3/PortfolioOverlap.git
cd PortfolioOverlap
virtualenv venv
source venv/bin/activate
pip3 install -r requirements.txt

How to use

First, insert your portfolio into the file portfolio.yml in the format ISIN: number of shares held. It is recommended to append the ticker symbol as a comment to the end of the line to make it easier identifying the equity. It is possible to add common stocks and ETFs to the portfolio.

US0378331005: 1.0 # AAPL
US5949181045: 2.0 # MSFT
US0231351067: 3.0 # AMZN
US88160R1014: 4.0 # TSLA
US00214Q1040: 5.0 # ARKK (ETF)

The tool also uses the AlphaVantage API to fetch the current price of the stocks in your portfolio. To use the API, you need to get a free API key at AlphaVantage. In the root directory of the project, create a file named .env and add your API key as follows:

ALPHA_VANTAGE_API_KEY = "API_KEY"

Then, run the tool

python3 portfoliooverlap/main.py

Using the portfolio above yields the following insights

ETFs sorted by weighted overlap in descending order (with individual equity overlap)
------
ARK INNOVATION ETF
Overlap: 13.5916%
Top 5: TESLA INC (10.38%), COINBASE GLOBAL INC (0.22%), UNITY SOFTWARE INC (0.21%), TELADOC HEALTH INC (0.21%), ROKU INC (0.19%)
------------
ARK Next Generation Internet ETF
Overlap: 13.1095%
Top 5: TESLA INC (10.22%), COINBASE GLOBAL INC (0.22%), UNITY SOFTWARE INC (0.21%), TELADOC HEALTH INC (0.21%), ROKU INC (0.19%)
------------
ARK Autonomous Technology & Robotics ETF
Overlap: 12.4104%
Top 5: TESLA INC (11.59%), UNITY SOFTWARE INC (0.21%), UIPATH INC CLASS (0.12%), PALANTIR TECHNOLOGIES (0.1%), IRIDIUM COMMUNICATIONS INC (0.05%)
...