Skip to content

Omrigotlieb/sss

 
 

Repository files navigation

SSS Overview

Stock Scanner & Screener: A yfinance+investpy combined-based Stock Scanner & Screener for the Israeli and US Stock Markets (Extendable to other stock markets as well). Within the code, the following libraries and fonts are used:

SSS Core Equation

http://bit.ly/SssCoreEquation

SSS Big Data (Muti-Dimentional) Analysis and Advanced Ranking Equation

http://bit.ly/SssBigDataAnalysis

Setup

  • Install Python 3.7 or higher from https://www.python.org/downloads/
  • Install Pycharm Community Edition from https://www.jetbrains.com/pycharm/download/
  • Download the SSS source code as a Zip file from this page (https://github.com/asafravid/sss/archive/master.zip) or clone/fork the repository directly
  • Open Project from folder (to which you unzipped the sss source code)
  • No further steps required apart from pip3 installing relevant libraries:
    • cd <[path to]Python 3.7>
    • pip3 install pandas
    • pip3 install yfinance
    • pip3 install investpy
  • Note that for yfinance - I'm providing updated sources since they take time to update by the developers, and my forks are, well - mine, and I prefer one to pip3 install yfinance from the origin, and then update (using comparison SW) the necessary changes I made (not too many) to run the SSS most efficiently and informatively.

Run Step-By-Step Instructions

  • 1: Run the scanning mode by uncommenting the Run Build DB Only lines in sss_run.py
  • 2: A result folder shall be created under Results Folder
  • 3: Run research mode, selecting profit margin (pm) Enterprise value to Revenue Ratio (evr) scanning parameters (just use the defaults - they are fine)
  • 4: Reccomendation list shall appear in the result folder fed to the Research Mode
  • 5: Optional (and recommended) - Run diff module (sss_diff.run()) to observe differnces (new/removed/moved up/down stocks) from last run

Track Your Investments - Reference Sheet

http://bit.ly/SssResultsInvestmentTracking

Indices Maintenance (Once per month)

Disclaimer

  • Make your analysis before buying the reccommended stocks
  • This Stock Screener/Scanner shall only provide reccomendations
  • Buying the reccommended stocks is at your own risk
  • Study the companies reccommended - read their financial reports, and only then decide if and how much to buy

yfinance.7z Usage

  • yfinance is a known library which this scanner uses
  • Several Bugs were found upon examining the code of yfinance, and I have created pull requests for those.
  • For simplicity, unzip yfinance.7z and beyond[or other comparison software]-compare it with the official [pip3 it] one, and take the changes provided within this library's yfinance.7z.

Understanding and Verifying Units of yfinance parameters

  • Units can compared to https://www.macroaxis.com/stock-analysis/CMRE/Costamare (i.e. CMRE can be replaced for any stock ticker/symbol)
  • Use case: CMRE's yfinance earningsQuarterlyGrowth is -0.298, and website shows -29.80% so the match yields that yfinance reports in direct ratio (not %)

Looking Forward for Contributions

  • Good luck and you are welcome to contribute to this project:
    • Add other contries' stocks
    • Past reccomendations and present results - for proving that the model works
    • Multi-Dimentional Big Data research mode (scan over EQGs, etc)
    • For any questions / issues / suggestions: You can reach me here: asaf.rvd@gmail.com

About

Stock Scanner & Screener: A yfinance + investpy combined-based Stock Scanner and Screener

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 99.7%
  • Batchfile 0.3%