Analyze stock trades and portfolio performance with optional Robinhood MFA export: CSV filtering, FIFO, Yahoo Finance pricing, and charts for strategy review.

Source: robinhood_stock_analyzer

Features

• Transaction Filtering: Filter and display stock transactions from a CSV file in a tabular format.
• Total Analysis: Analyze total bought and sold quantities for specific stocks.
• Outstanding Stock Calculation: Calculate outstanding stock quantities using FIFO order and assess profit/loss based on current prices.
• Historical Data Visualization: Fetch and plot historical stock prices, highlighting key buy/sell points and trends.
• Integration with Robinhood: Optionally generate transaction data from Robinhood using MFA authentication.

Setting Up Multi-Factor Authentication (MFA) for Robinhood

1. Install a TOTP App

To enable MFA for your Robinhood account, you’ll need a Time-based One-Time Password (TOTP) application, such as Google Authenticator, Authy, or any other TOTP-compatible app.

2. Enable MFA on Robinhood

1. Log in to Robinhood: Open the Robinhood app or website and log in to your account.
2. Go to Security and Privacy Settings: Navigate to your Account -> Settings -> Security and privacy.
3. Enable Two-Factor Authentication:
   • Find the Two-Factor Authentication (2FA) or Multi-Factor Authentication (MFA) option.
   • Follow the prompts to enable MFA with Authenticator App.
4. Scan the QR Code:
   • Robinhood will show you a QR code.
   • Open your TOTP app and scan the QR code to add your Robinhood account.
   • The app will start generating time-based codes for Robinhood.

3. Retrieve Your TOTP Secret

• In the same security section where you enabled MFA, you should be able to see or generate a backup key or secret key (usually a 16-character string).
• Copy this secret key.

4. Add robin_mfa to .env File

1. Create or Open the .env File: If you don’t already have a .env file in your project directory, create one. This file will store your environment variables.

2. Add your Robinhood credentials (including the TOTP secret used to generate MFA codes):

   robin_username=your_robinhood_username
   robin_password=your_robinhood_password
   robin_mfa=YOUR_TOTP_SECRET
   

   Replace YOUR_TOTP_SECRET with the backup or secret key from Robinhood (often a Base32 string).

5. Using MFA in your application

When you run your application, the robin_mfa variable will be used to generate a TOTP code automatically, which is required for logging in to Robinhood.

6. Testing the MFA Setup

Run your application and verify that it logs in successfully using the generated TOTP code. If you encounter any issues, double-check that the robin_mfa value in your .env file is correct.

Setup and Installation

1. Clone the Repository:

   git clone https://github.com/uppusaikiran/robinhood_stock_analyzer.git
   cd robinhood_stock_analyzer
   

2. Create a Virtual Environment (optional but recommended):

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   

3. Install Dependencies:

   Create a .env file in the root directory with your Robinhood credentials and MFA code:

   robin_username=your_robinhood_username
   robin_password=your_robinhood_password
   robin_mfa=your_robinhood_mfa_secret
   

   Install the required packages:

   pip install -r requirements.txt
   

Usage

1. Run the Analyzer:

   Use command-line arguments to specify the stock symbol, start date, and CSV file path.

   python stock_analyzer.py --symbol AAPL --start_date 2023-01-01
   

   Arguments:

   • --symbol: The stock symbol to analyze (e.g., AAPL).
   • --start_date: The start date for the analysis in YYYY-MM-DD format (optional).
   • --file: The path to the CSV file (optional, default is ./stock_orders.csv).
   • --generate_data: Set to True to generate new transaction data from Robinhood (requires environment variables).

2. Output:

   • Displays filtered transactions for the specified stock symbol.
   • Analyzes and prints total bought and sold quantities.
   • Calculates and prints outstanding stock quantities and detailed sales information.
   • Plots historical stock prices and key transaction points.

Example

python stock_analyzer.py --symbol MSFT --start_date 2023-01-01 --file ./my_stock_orders.csv

Contributing

Feel free to submit issues or pull requests. Contributions are welcome!

License

This project is licensed under the MIT License. See the LICENSE file for more details.