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. π°π
- Host: GitHub
- URL: https://github.com/netbr3ak/stockscorepro
- Owner: NetBr3ak
- License: mit
- Created: 2025-03-13T17:09:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-13T17:52:59.000Z (7 months ago)
- Last Synced: 2025-03-20T22:29:10.339Z (7 months ago)
- Topics: finance, investment, moving-average, pandas, stocks, yfinance
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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.886Proposed investment distribution based on your monthly budget:
Company InvestmentFraction InvestmentAmount
Apple 0.332 996.00
Microsoft 0.352 1056.00
Nike 0.316 948.00Analysis 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!** ππ