Repository files navigation

• Utilizingyfinance [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/):

http://bit.ly/SssCoreEquation

https://bit.ly/MultiDimensionalScan

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

• Mandatory Python Libraries:

  • https://pypi.org/project/yfinance/
  • https://pypi.org/project/fpdf/
  • https://pypi.org/project/pandas/

• Reccomended Python Libraries (Backup Internal independent Forex Tables are partially maintained):

  • https://pypi.org/project/forex-python/
  • https://pypi.org/project/CurrencyConverter/
  • https://pypi.org/project/py-currency-converter/
  • https://pypi.org/project/PyCurrency-Converter/
  • https://pypi.org/project/currency.converter/

• Fonts:

  • https://fonts2u.com/dejavu-sans-condensed.font

• InstallPython 3.6 or higher fromhttps://www.python.org/downloads/

• (Reccomended but Optional) InstallPycharm Community Edition fromhttps://www.jetbrains.com/pycharm/download/

• Download the 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 thesss source code)

• No further steps required apart frompip[3] installing relevant libraries:

  • Mandatory
    • pip[3] install pandas
    • pip[3] install yfinance
    • pip[3] install yahooquery
    • pip[3] install fpdf
    • pip[3] install pyPdf
    • pip[3] install numpy
    • pip[3] install forex_python and/orpip[3] install forex-python
    • pip[3] install CurrencyConverter
    • pip[3] install PyCurrency-Converter
    • pip[3] install currency.converter

• 1: Setmulti_dim_scan_mode toFalse and for 1st time run, you may setreference_run_<mode> toNone (or to latest relevant directory in results)
• 2: Set the required scanning mode(s) (custom/tase/nsr/all) insss_config.py and runsss_run.py
• 3: A (New)Results/<scan_mode>/<date_and_time>_..._<num_results> directory shall be created underResults/<mode>/ directory
• 4: Feed theResults path into themulti_dim_scan_mode = True (Multi-Dimensional Scan). APDF andresults_sss_*.csv files shall be created in the same directory
• 5: Crash and Continue from crash point - Supported for efficiency.

• DownloadTASE latest components viahttps://info.tase.co.il/eng/MarketData/Stocks/MarketData/Pages/MarketData.aspx intoIndices/Data_TASE.csv -> This operation is done automatically upon each scan (withresearch_mode = False) viasss_indices.py
• DownloadNASDAQ100 latest components viahttps://www.nasdaq.com/market-activity/quotes/nasdaq-ndx-index intoIndices/nasdaq100-components.csv
• DownloadRussel1000 latest components viahttps://en.wikipedia.org/wiki/Russell_1000_Index intorussell-1000-index.csv
• DownloadS&P500 latest components intoIndices/snp500-components.csv (Remove last line indicating creation date)
• DownloadNASDAQ latest components (otherlisted.txt,nasdaqlisted.txt,otherlisted.txt) viaftp://ftp.nasdaqtrader.com/symboldirectory/ into theIndices/ directory (Convert.txt to.csv) using an FTP Client (such ashttps://filezilla-project.org/) -> This operation is done automatically upon each scan (withresearch_mode = False)
• You can also create your own indice/group of stocks by either overriding the above files' contents or simply adding your own indice to the code support. Use Custom Mode, and example insss_config.py
• Checkouthttp://www.nasdaqtrader.com/trader.aspx?id=symboldirdefs for all symbol definitions (for instance -$ in stock names, 5-letter stocks ending withY, etc)

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

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

• 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 readysss_results_performance.py)
  • Multi-Dimensional Scan enhancements (scan overEQGs, etc)
  • For any questions / issues / suggestions: You can reach me here:asaf.rvd@gmail.com

      Copyright (C) 2021  Asaf Ravid <asaf.rvd@gmail.com>This program is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe 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 ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See theGNU General Public License for more details.You should have received a copy of the GNU General Public Licensealong with this program.  If not, see <https://www.gnu.org/licenses/>.