Skip to content
/ sss Public

Stock Scanner & Screener: A yfinance-based Stock Scanner and Screener, focusing on Fundamental Properties of scanned stocks.

License

Notifications You must be signed in to change notification settings

asafravid/sss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview

  • Utilizing yfinance [non-API based] +yahooquery [API-based] - Stock Scanner & Screener Based on a Core Equation of Fundamental Financial Properties, followed by a Multi-dimensional Scan Ranking process.
  • Supports Custom Portfolio and the Israeli, US, Swedish and Swiss Stock Markets (Extendable to other stock markets as well).
  • The stocks scan and sorting is done according to the below documentation (Core Equation and Multi-Dimensional scan) written using Google Documents (https://www.google.com/docs/about/):

Core Equation

http://bit.ly/SssCoreEquation

Muti-Dimensional Scan and Ranking Equation

https://bit.ly/MultiDimensionalScan

Setup

Within the code, the following libraries and fonts are used:

Run Step-By-Step Instructions

  • 1: Set multi_dim_scan_mode to False and for 1st time run, you may set reference_run_<mode> to None (or to latest relevant directory in results)
  • 2: Set the required scanning mode(s) (custom/tase/nsr/all) in sss_config.py and run sss_run.py
  • 3: A (New) Results/<scan_mode>/<date_and_time>_..._<num_results> directory shall be created under Results/<mode>/ directory
  • 4: Feed the Results path into the multi_dim_scan_mode = True (Multi-Dimensional Scan). A PDF and results_sss_*.csv files shall be created in the same directory
  • 5: Crash and Continue from crash point - Supported for efficiency.

Indices Maintenance

Disclaimer

  • The Scan Results are By No Neans to be interpreted as reccomendations.
  • The Results are merely a basis for Research and Analysis.

Understanding and Verifying Units of yfinance parameters

  • Units can be 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

  • You are encouraged to contribute to this project:
    • Add other contries' stock markets
    • Past reccomendations and present results - for proving that the model works (a prototype is ready sss_results_performance.py)
    • Multi-Dimensional Scan enhancements (scan over EQGs, etc)
    • For any questions / issues / suggestions: You can reach me here: asaf.rvd@gmail.com

License

      Copyright (C) 2021  Asaf Ravid <asaf.rvd@gmail.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.