An open API service indexing awesome lists of open source software.

https://github.com/netbr3ak/stockscorepro

StockScorePro is a clear, intelligent, and data-driven investment tool that evaluates stocks based on their current price relative to their 50-day moving average. It identifies attractive investment opportunities by analyzing price stability, valuation, and potential undervaluation. πŸ’°πŸ“Š
https://github.com/netbr3ak/stockscorepro

finance investment moving-average pandas stocks yfinance

Last synced: 4 months ago
JSON representation

StockScorePro is a clear, intelligent, and data-driven investment tool that evaluates stocks based on their current price relative to their 50-day moving average. It identifies attractive investment opportunities by analyzing price stability, valuation, and potential undervaluation. πŸ’°πŸ“Š

Awesome Lists containing this project

README

          

# πŸ“ˆ **StockScorePro: Your Smart Investment Assistant**

StockScorePro is an intelligent and user-friendly investment tool designed to analyze stocks based on their current prices relative to their 50-day moving average. It identifies attractive investment opportunities by evaluating price stability, closeness to average pricing, and potential undervaluation. πŸ’°πŸ“Š

This tool is ideal when you have a specific list of companies you'd like to invest in long-term. You manually enter your favorite companies' stock tickers directly into the script, and StockScorePro will take care of the analysis for you.

---

## πŸš€ **How Does StockScorePro Work?**

StockScorePro evaluates each stock using three clear indicators:

- **Stability 🧘**:
*How stable has the stock’s average price been recently?*
**Example:** If a stock’s average price has barely changed in recent days, it scores close to 1 (very stable).

- **Closeness 🎯**:
*How close is the current stock price to its 50-day average?*
**Example:** If a stock’s current price matches its 50-day average, the Closeness score is 1 (perfect match).

- **ExtraValue ✨**:
*Is the stock priced below its 50-day average, potentially offering extra value?*
**Example:** A stock trading 5% below its average receives a 5% bonus (ExtraValue score: 1.05).

These indicators combine into a single **OverallScore πŸ…**, making it easy for you to spot attractive investment opportunities quickly.

---

## πŸ› οΈ **Installation & Quick Start**

Follow these simple steps to start using StockScorePro:

### **1. Install Required Libraries**

```bash
pip install yfinance pandas numpy
```

### **2. Customize the List of Companies**

- Open the `stockscorepro.py` file.
- Find the list named `tickers`.
- Replace the provided tickers with your preferred long-term investment companies.

### **3. Run StockScorePro**

Save your changes and run the script:

```bash
python stockscorepro.py
```

You will be prompted to enter your monthly investment amount (e.g., 1500).

---

## πŸ” **Example Results**

When you run StockScorePro, you'll get clear results like this:

```bash
Evaluation results (higher OverallScore indicates a potentially better investment):

Company LatestPrice 50DayAverage PriceDifferencePercent Stability Closeness ExtraValue OverallScore
Apple 145.3 150.0 -0.031 0.980 0.920 1.031 0.930
Microsoft 290.5 289.0 0.005 0.995 0.990 1.000 0.985
Nike 120.2 125.0 -0.038 0.970 0.880 1.038 0.886

Proposed investment distribution based on your monthly budget:

Company InvestmentFraction InvestmentAmount
Apple 0.332 996.00
Microsoft 0.352 1056.00
Nike 0.316 948.00

Analysis completed on: 2025-03-13 15:45:30
```

---

## πŸ“Œ **Why Use StockScorePro?**

- βœ… **Clear & Practical**: Easily identify attractive stocks without complicated analysis.
- βœ… **Data-Driven**: Make decisions using reliable market information.
- βœ… **Time Efficient**: Quickly evaluate multiple stocks simultaneously.
- βœ… **Optimized Investment**: Automatically distribute your capital efficiently.

---

## ⚠️ **Important Disclaimer**

StockScorePro is intended for educational purposes. Always do additional research before investing. Investing involves risk, and past performance does not guarantee future returns.

---

## πŸ“© **Contact & Contribution**

Got feedback or questions? Feel free to reach out and help improve StockScorePro!

πŸ’‘ **Happy Investing!** πŸš€πŸŒŸ