pkscreener


Namepkscreener JSON
Version 0.44.20240504.333 PyPI version JSON
download
home_pagehttps://github.com/pkjmesra/pkscreener
SummaryA Python-based stock screener for NSE, India with alerts to Telegram Channel (pkscreener)
upload_time2024-05-04 08:16:20
maintainerNone
docs_urlNone
authorpkjmesra
requires_pythonNone
licenseOSI Approved (MIT)
keywords nse technical indicators scanning stock scanners
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            ![Title](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/title.png)

# PKScreener

[![MADE-IN-INDIA][MADE-IN-INDIA-badge]][MADE-IN-INDIA] [![Windows][Windows-badge]][Windows] [![Linux][Linux-badge]][Linux] [![Mac OS][Mac OS-badge]][Mac OS] [![GitHub release (latest by date)][GitHub release (latest by date)-badge]][GitHub release (latest by date)] [![CodeFactor][Codefactor-badge]][Codefactor] [![Downloads][Downloads-badge]][Downloads] ![latest download][Latest-Downloads-badge] ![github license][github-license] [![PyPI][pypi-badge]][pypi] [![is wheel][wheel-badge]][pypi] [![Coverage Status][Coverage-Status-badge]][Coverage-Status] [![codecov][codecov-badge]][codecov] [![Docker Status][Docker Status-badge]][Docker Status]
[![Docker Pulls][Docker Pulls-badge]][Docker Status]

## What is PKScreener?
| Telegram Alerts | Nifty AI Prediction | Scheduling Cron Jobs | On-Demand Telegram Bot | Backtesting / Growth of 10k |
| :-------------: | :-----------------: | :------------------: | :--------------------: | --------------------------- |

| Nifty screening | Volume scanners | Breakout detection | Consolidating stocks | Reversal Signals |
| :-------------: | :-------------: | :----------------: | :------------------: | ---------------- |

| Chart Patterns | CCI scanners | 2% scanners | Short-term bulls | NR4 / NR7 | Weekly Releases |
| :------------: | :----------: | :---------: | :--------------: | :-------: | --------------- |

| Fair Value | Mutual funds, FII data | TTM Squeeze | Golden Crossover | Death Crossover |
| :--------: | :--------------------: | :---------: | :--------------: | --------------- |

| RSI screening | MACD scanners | IPO Stocks | Momentum Gainers | Watchlist screening |
| :-----------: | :-----------: | :--------: | :--------------: | ------------------- |

| Stock Performance | 52Wk H/L Breakouts | 10 days low breakouts | Aroon Crossover | Next Day Bullish Stocks |
| :---------------: | :----------------: | :-------------------: | :-------------: | ----------------------- |

| Today's Breakouts | Breaking out now | Popular stocks by Mutual Funds / FIIs | Higher Highs | Lower Lows |
| :---------------: | :--------------: | :-----------------------------------: | :----------: | ---------- |

| F&O Stocks screening | Live 5-EMA Index Scan | Logging | Telegram Channel | Early Breakouts |
| :------------------: | :-------------------: | :-----: | :--------------: | --------------- |
### A Python-based stock screener for NSE, India.

**pkscreener** is an advanced stock screener to find potential breakout stocks from NSE and tell it's possible breakout values. It also helps to find the stocks which are consolidating and may breakout, or the particular chart patterns that you're looking specifically to make your decisions.
pkscreener is totally customizable and it can screen stocks with the settings that you have provided.

You can get daily scan results/alerts at scheduled times by subscribing to the following Telegram channel:
|    Purpose     |                                                                                                                   Description/link                                                                                                                    | QR Code                                                                                                                                          |     |     |
| :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------ | --- | --- |
| Alerts Channel | https://t.me/PKScreener > You wil receive all the major alerts on this telegram channel. These alerts are sent for all major strategy scans daily around 9:30am-10:15am and then around 4pm. You will also receive the next day's market predictions. | <img src="https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/Telegram_Channel_Prod.jpg" alt="Telegram Channel" width="100"/> |     |     |
|                |                                                                                                                                                                                                                                                       |                                                                                                                                                  |     |     |

![telegram](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/telegram.png)

## Receiving Scheduled Scan results
If you would like to receive the scan results, please join the telegram channel and group above. 
You may receive the following scan results:
1. [![1. Next day Nifty/Market AI prediction](https://github.com/pkjmesra/PKScreener/actions/workflows/w4-workflow-prod-scans_1.yml/badge.svg)](https://github.com/pkjmesra/PKScreener/actions/workflows/w4-workflow-prod-scans_1.yml) by 4pm IST, Monday - Friday
2. For all Nifty stocks at/by 9:45-10:15am and by 4pm IST, Monday - Friday

   * Certain selected but configurable alerts for specific scan types

## Receiving On-Demand Scan results
You can now run the `pkscreenerbot` on your local machine or if it's running on the GitHub server under a GitHub Actions workflow, you can use the `pkscreener Bot`(@nse_pkscreener_bot on Telegram) to get on-demand scan results.

![bot](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/bot.gif)

## Scanners

Screening options to choose from:
* Artificial Intelligence v2 for Nifty 50 Prediction
* Live Index Scan : 5 EMA for Intraday
* Screen stocks by the stock names (NSE Stock Code)
* Nifty 50
* Nifty Next 50
* Nifty 100
* Nifty 200
* Nifty 500
* Nifty Smallcap 50
* Nifty Smallcap 100
* Nifty Smallcap 250
* Nifty Midcap 50
* Nifty Midcap 100
* Nifty Midcap 150
* Nifty (All Stocks)
* Newly Listed (IPOs in last 2 Year)
* F&O Stocks Only
* NASDAQ

Followin scanners are already implemented. Others are `In Progress`
```
0 > Full Screening (Shows Technical Parameters without any criterion)
     1 > Probable Breakouts              	2 > Today's Breakouts
     3 > Consolidating stocks            	4 > Lowest Volume in last 'N'-days (Early Breakout Detection)
     5 > RSI screening                   	6 > Reversal Signals
     7 > Stocks making Chart Patterns    	8 > CCI outside of the given range
     9 > Volume gainers                  	10 > Closing at least 2% up since last 3 days
    11 > Short term bullish stocks(Intraday)	12 > 15 Minute Price & Volume breakout(Intraday)
    13 > Bullish RSI & MACD(Intraday)       	14 > NR4 Daily Today
    15 > 52 week low breakout(today/1 wk)	16 > 10 days low breakout
    17 > 52 week high breakout(today/1 wk)	18 > Bullish Aroon(14) Crossover
    19 > MACD Histogram x below 0       	20 > Bullish for next day
    21 > Most Popular Stocks            	22 > View Stock Performance         
    23 > Breaking out now               	24 > Higher Highs,Lows & Close      
    25 > Lower Highs,Lows (Watch for Reversal)            	
```
## How to use on your own local Windows/Linux/Macbook laptop?

# Using docker, running within docker container
* Download and install docker desktop: https://docs.docker.com/get-docker/
* After installation, launch/run docker desktop and if it asks, login using your docker credentials.
* Launch any command line (for example, cmd on windows or terminal on Mac) and type `docker pull pkjmesra/pkscreener:latest`. Then type `docker run -it pkjmesra/pkscreener:latest`.  
  The option `-i` will open the `pkscreener` in interactive mode within docker. `-t` will allocate a pseudo terminal for you so you can begin to use `pkscreener`

# Installing the latest version from PyPi.
* Go ahead and install using `pip install pkscreener`
* This should install all of the major dependencies, except maybe, TA-Lib.
* This app can still run without TA-Lib, but if you need to install TA-Lib for technical indicators (which otherwise is used from `pandas_ta` in the absence of TA-Lib), you can do this: Head to `.github/dependencies/` under this repo. Download the respective TA-Lib file/whl file and install either from the .whl file or from source. Check out any of the workflow files for steps to install TA-Lib.

For example:

For `Windows`: See https://github.com/pkjmesra/PKScreener/blob/c1e94ba3137915cb781161fa2d5fb69129940fd3/.github/workflows/w1-workflow-build-matrix.yml#L91-L101

For `Mac`: Run `brew install ta-lib` assuming you have homebrew installed.

For `Ubuntu/Linux`: See https://github.com/pkjmesra/PKScreener/blob/main/.github/workflows/w1-workflow-build-matrix.yml#L121-L132

* Now launch your favorite command line CLI and issue `pkscreener`. This will launch the pkscreener executable.

# Building from source repo
* Install python 3.9 for your OS/CPU. Download the installer from https://www.python.org/downloads/release/python-3913/#Files
* Just clone the repo with `git clone https://github.com/pkjmesra/PKScreener.git`
* `cd PKScreener`
* `pip install -r requirements.txt` .
* (Optional) If you would like to have technical indicators evaluated using TA-Lib, go ahead and install TA-Lib as well. `pip3 install ta-lib`. Please review additional steps to buil TA-Lib in the workflow files meant for your OS under .github > workflows and follow the line numbers from the previous section.
* `cd pkscreener`
* Finally, from within the `pkscreener` directory, run `python pkscreenercli.py`. Or just type/run `pkscreener`. You are all set.

# Running the executables
* Download the suitable file according to your OS.
* Linux & Mac users should make sure that the `pkscreenercli.bin or pkscreenercli.run` is having `execute` permission. (`chmod +x pkscreenercli.run`)

* **Run** the file. Following window will appear.


* **Configure** the parameters as per your requirement using `Option > E`.

![config](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/config.png)

* **Scanner Menus** the scanner menus for each level/sub-level
  ![menulevel1](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu.png)
  ![menulevel2](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu_level2.png)
  ![menulevel3](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu_level3.png)


* Following are the screenshots of screening and output results.

![screening](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/screening.png)

Results :

![results](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/results.png)

It also shows you how the chosen scan option has fared in the past. 1-Pd, 2-Pd means 1 day, 2 days from the date of scan in the past when those stocks came into the results of the chosen scan option.

![results](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/result_analysis.png)
* Once done, you can also save the results in an excel file.

## Growth of 10k

You can see the performance of your stocks and/or at portfolio level using "Growth of 10k".

![G10k](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/G10k.png)

It also summarises the Growth of 10k at portfolio level for the last quarter so that you know which filters worked best in the past:

![G10k_Sum](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/G10k_Sum.png)

## Backtests
You can now use the *Backtests* menu to backtest any of the selected strategies. See https://pkjmesra.github.io/PKScreener/BacktestReports.html

![backtest](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/backtest.png)

* Once done, you can also view the output html file saved at the same location from where you launched the app.

## Scanning as a scheduled job once or at regular intervals
* Running it once with pre-defined inputs
  You can also run it as a one time job in any scheduler with pre-defined options. For example `./pkscreenercli.py -a Y -o X:12:10 -e` (or `pkscreenercli.exe -a Y -o X:12:10 -e` if you're executing with the exe) will run the scanner for all Nifty stocks and find all stocks matching CCI filter, save the results in xlsx file and exit. `./pkscreenercli.py -a Y -o X:12:9:2.5 -e` will run the scanner (menu option `X`) for all Nifty stocks (menu option `12`) to find volume gainers (menu option `9`) with at least the volume multiplier of 2.5 (input variable `2.5`), save the results in xlsx file and exit (menu option `-e`). Passing in the `-p` option for example `pkscreenercli.py -a Y -p -o X:12:6:1 -e` will also silence all command line prints/outputs and just run silently for the given options, save results and exit. Try and see all options with `./pkscreenercli.py -h`.

* Running it at regular intervals
  If you want to runn it at regular intervals, you can just pass the interval in `-c` command line option. For example, `./pkscreenercli.py -a Y -o X:12:6:1 -c 180` will run it every `180` seconds with console outputs also being printed. If you'd just like it to run as a cron job without console outputs, you may also pass the `-p` parameter. For example, `./pkscreenercli.py -a Y -p -o X:12:6:1 -c 180`

## Understanding the Result Table:

The Result table contains a lot of different parameters which can be pretty overwhelming to the new users, so here's the description and significance of each parameter.

| Sr  |       Parameter       | Description                                                                                                                                                                                                                  | Example                                                                                  |
| :-: | :-------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|  1  |       **Stock**       | This is a NSE scrip symbol. If your OS/Terminal supports unicode, You can directly open **[TradingView](https://in.tradingview.com/)** charts by pressing `Ctrl+Click` on the stock name.                                    | [TATAMOTORS](https://in.tradingview.com/chart?symbol=NSE%3ATATAMOTORS)                   |
|  2  |   **Consolidating**   | It gives the price range in which stock is trading since last `N` days. `N` is configurable and can be modified by executing `Edit User Configuration` option.                                                               | If stock is trading between price 100-120 in last 30 days, Output will be `Range:20.0 %` |
|  3  | **Breakout (N Days)** | This is pure magic! The `BO` is Breakout level in last N days while `R` is the next resistance level if available. Investor should consider both BO & R level to decide entry/exits in their trades.                         | `B:302, R:313`(Breakout level is 100 & Next resistance is 102)                           |
|  4  |        **LTP**        | LTP is the Last Traded Price of an asset traded on NSE.                                                                                                                                                                      | `298.7` (Stock is trading at this price)                                                 |
|  5  |      **Volume**       | Volume shows the relative volume of the recent candle with respect to 20 period MA of Volume. It could be `Unknown` for newly listed stocks.                                                                                 | if 20MA(Volume) is 1M and todays Volume is 2.8M, then `Volume = 2.8x`                    |
|  6  |     **MA-Signal**     | It describes the price trend of an asset by analysing various 50-200 MA/EMA crossover strategies.                                                                                                                            | `200MA-Support`,`BullCross-50MA` etc                                                     |
|  7  |        **RSI**        | For the momentum traders, it describes 14-period RSI for quick decision making about their trading plans                                                                                                                     | `0 to 100`                                                                               |
|  8  |       **Trend**       | By using advance algorithms, the average trendlines are computed for `N` days and their strenght is displayed depending on steepness of trendlines. (This does NOT show any trendline on chart, it is calculated internally) | `Strong Up`, `Weak Down` etc.                                                            |
|  9  |      **Pattern**      | If the chart or the candle itself forming any important pattern in the recent timeframe or as per the selected screening option, various important patterns will be indicated here.                                          | `Momentum Gainer`, `Inside Bar (N)`,`Bullish Engulfing` etc.                             |

## Hack it your way:
Feel free to Edit the parameters in the `pkscreener.ini` file which will be generated by the application.
```
[config]
period = 280d
daystolookback = 22
duration = 1d
minprice = 20.0
maxprice = 50000.0
volumeratio = 2.5
consolidationpercentage = 10.0
shuffle = y
cachestockdata = y
onlystagetwostocks = y
useema = n
showunknowntrends = y
logsenabled = n
generaltimeout = 2.0
longtimeout = 4.0
maxnetworkretrycount = 10
backtestperiod = 60
minimumvolume = 10000
```
Try to tweak this parameters as per your trading styles. For example, If you're comfortable with weekly charts, make `duration=5d` and so on. For intraday, you can set `period=1d and duration=5m` if you would like to calculate with 5minute candles. Set the duration to `15m` or whatever value you desire, but keep the period to `1d`. This tool, however, works best for short/mid term instead of intraday, but some scans like momentum/volume/NR4 etc can be used for screening stocks for intraday as well. You can use the toggle menu option `T` to toggle between long term and intraday config before you begin the scanners.

## Creating your own Telegram channel to receive your own alerts:
You can create your own telegram channel to receive alerts wherenevr you run it locally on your laptop either from a command line interface console or run it as a scheduler. Simply, go ahead and
1. Create a bot for yourself, then a channel and get their IDs. Follow the steps in https://medium.com/codex/using-python-to-send-telegram-messages-in-3-simple-steps-419a8b5e5e2 and https://www.siteguarding.com/en/how-to-get-telegram-bot-api-token
2. After you have created the bot using `botFather` and have received/verified your bot id/token and channel ID using `get id bot`, simply go to `pkscreener` folder in the source code directory and create a `.env.dev` file with the following (If you are instead using the .exe or .bin or .run file from release, just create this file in the same folder where the executable (.exe or .bin or .run) is placed.)
```
CHAT_ID=Your_Channel_Id_Here_Without_A_Hyphen_or_Minus_Sign
TOKEN=Your_Bot_Token_Here
chat_idADMIN=Your_Own_ID_Here
```
3. From now on, you will begin to receive your own alerts on your telegram channel.
   ![alerts](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/alerts.png)

## Troubleshooting and Logs:
If you are having issues running the program, you can just launch a command line interface (On windows> Start > Run > cmd) and then launch PKScreener with a command line option of `-l`. For example, `python pkscreenercli.py -l`. This will show you the path where the program will save all the log outputs from this run. Copy that path and go ahead and run the application. Altenatively, you can just go ahead and modify the `logsEnabled` value to `y`, save & close it and then run `python pkscreenercli.py`.

After you have finished the run, go to that copied path, zip the contents of the file `pkscreener-logs.txt` and create an issue at https://github.com/pkjmesra/PKScreener/issues. Please do not forget to attach the log files in the issue.

## Contributing:
* Please feel free to Suggest improvements bugs by creating an issue.
* Please follow the [Guidelines for Contributing](https://github.com/pkjmesra/PKScreener/blob/main/CONTRIBUTING.md) while making a Pull Request.

## Disclaimer:
* DO NOT use the results provided by the software 'solely' to make your trading decisions.
* Always backtest and analyze the stocks manually before you trade.
* The Author(s), the software and any related/unrelated entity will not be held liable for your own investing decisions or losses. The authors or this softfware does not make any claim about the correctness of the results.
* This screener began as a [fork](https://github.com/pranjal-joshi/Screeni-py) but has since added a lot of additional scanners, backtesting, Telegram bots, Alerts and a number of modifications and improvements.

[MADE-IN-INDIA-badge]: https://img.shields.io/badge/MADE%20WITH%20%E2%9D%A4%20IN-INDIA-orange
[MADE-IN-INDIA]: https://en.wikipedia.org/wiki/India
[Windows-badge]: https://img.shields.io/badge/Windows-0078D6?logo=windows&logoColor=white
[Windows]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.exe
[Linux-badge]: https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black
[Linux]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.bin
[Mac OS-badge]: https://img.shields.io/badge/mac%20os-D3D3D3?logo=apple&logoColor=000000
[Mac OS]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.run
[GitHub release (latest by date)-badge]: https://img.shields.io/github/v/release/pkjmesra/PKScreener
[GitHub release (latest by date)]: https://github.com/pkjmesra/PKScreener/releases/latest
[pypi-badge]: https://img.shields.io/pypi/v/pkscreener.svg?style=flat-square
[pypi]: https://pypi.python.org/pypi/pkscreener
[wheel-badge]: https://img.shields.io/pypi/wheel/pkscreener.svg?style=flat-square
[GitHub all releases]: https://img.shields.io/github/downloads/pkjmesra/PKScreener/total?color=Green&label=Downloads&style=for-the-badge
[License-badge]: https://img.shields.io/github/license/pkjmesra/PKScreener?style=for-the-badge
[License]: https://github.com/pkjmesra/PKScreener/blob/main/LICENSE
[Codefactor-badge]: https://www.codefactor.io/repository/github/pkjmesra/PKScreener/badge
[Codefactor]: https://www.codefactor.io/repository/github/pkjmesra/PKScreener
[PR-Guidelines-badge]: https://img.shields.io/badge/PULL%20REQUEST-GUIDELINES-red?style=for-the-badge
[PR-Guidelines]: https://github.com/pkjmesra/PKScreener/blob/new-features/CONTRIBUTING.md
[github-license]: https://img.shields.io/pypi/l/gspread?logo=github
[Downloads-badge]: https://static.pepy.tech/personalized-badge/pkscreener?period=total&units=international_system&left_color=black&right_color=brightgreen&left_text=PyPi%20Downloads
[Downloads]: https://pepy.tech/project/pkscreener
[Latest-Downloads-badge]: https://img.shields.io/github/downloads-pre/pkjmesra/pkscreener/latest/total?logo=github
[Coverage-Status-badge]: https://coveralls.io/repos/github/pkjmesra/PKScreener/badge.svg?branch=main
[Coverage-Status]: https://coveralls.io/github/pkjmesra/PKScreener?branch=main
[codecov-badge]: https://codecov.io/gh/pkjmesra/PKScreener/branch/main/graph/badge.svg
[codecov]: https://codecov.io/gh/pkjmesra/PKScreener
[Documentation-badge]: https://readthedocs.org/projects/pkscreener/badge/?version=latest
[Documentation]: https://pkscreener.readthedocs.io/en/latest/?badge=latest
[Docker Status-badge]: https://img.shields.io/docker/automated/pkjmesra/pkscreener.svg
[Docker Status]: https://hub.docker.com/repository/docker/pkjmesra/pkscreener
[Docker Pulls-badge]: https://img.shields.io/docker/pulls/pkjmesra/pkscreener.svg
[Prod Scan Tests-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w5-workflow-prod-scans_Tests.yml/badge.svg
[Prod Scan Tests]: https://github.com/pkjmesra/PKScreener/actions/workflows/w5-workflow-prod-scans_Tests.yml
[After Market-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w9-workflow-download-data.yml/badge.svg
[After Market]: https://github.com/pkjmesra/PKScreener/actions/workflows/w9-workflow-download-data.yml
[New Features-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w10-workflow-features-test.yml/badge.svg
[New Features]: https://github.com/pkjmesra/PKScreener/actions/workflows/w10-workflow-features-test.yml
[New Release-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w1-workflow-build-matrix.yml/badge.svg
[New Release]: https://github.com/pkjmesra/PKScreener/actions/workflows/w1-workflow-build-matrix.yml
[Docker-Build-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w15-docker-image.yml/badge.svg
[Docker-Build]: https://github.com/pkjmesra/PKScreener/actions/workflows/w15-docker-image.yml

<!-- [![Docker Build][Docker-Build-badge]][Docker-Build] [![PKScreener Test - New Features][New Features-badge]][New Features] [![w9. After-Market Data Gen][After Market-badge]][After Market] [![1. PKScreener Build - New Release][New Release-badge]][New Release] [![Documentation][Documentation-badge]][Documentation]

[![GitHub all releases][GitHub all releases]](#) [![GitHub][License-badge]][License] [![BADGE][PR-Guidelines-badge]][PR-Guidelines]
 [![w5. Production Scan Tests On Dev][Prod Scan Tests-badge]][Prod Scan Tests] 
-->

<!--      |                                                                                                                    Discussions []                                                                                                                     | https://t.me/PKScreeners > For any discussion related to PKScreener, you may like to join this related Telegram group                            | <img src="https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/PKScreeners_Group.jpg" alt="Telegram Group" width="100"/> | --> 

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pkjmesra/pkscreener",
    "name": "pkscreener",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "NSE, Technical Indicators, Scanning, Stock Scanners",
    "author": "pkjmesra",
    "author_email": "pkjmesra@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/49/48/d6d0d5b36be36bb650633c77591ab6dac505a3faa0713817983ad599fb06/pkscreener-0.44.20240504.333.tar.gz",
    "platform": null,
    "description": "![Title](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/title.png)\r\n\r\n# PKScreener\r\n\r\n[![MADE-IN-INDIA][MADE-IN-INDIA-badge]][MADE-IN-INDIA] [![Windows][Windows-badge]][Windows] [![Linux][Linux-badge]][Linux] [![Mac OS][Mac OS-badge]][Mac OS] [![GitHub release (latest by date)][GitHub release (latest by date)-badge]][GitHub release (latest by date)] [![CodeFactor][Codefactor-badge]][Codefactor] [![Downloads][Downloads-badge]][Downloads] ![latest download][Latest-Downloads-badge] ![github license][github-license] [![PyPI][pypi-badge]][pypi] [![is wheel][wheel-badge]][pypi] [![Coverage Status][Coverage-Status-badge]][Coverage-Status] [![codecov][codecov-badge]][codecov] [![Docker Status][Docker Status-badge]][Docker Status]\r\n[![Docker Pulls][Docker Pulls-badge]][Docker Status]\r\n\r\n## What is PKScreener?\r\n| Telegram Alerts | Nifty AI Prediction | Scheduling Cron Jobs | On-Demand Telegram Bot | Backtesting / Growth of 10k |\r\n| :-------------: | :-----------------: | :------------------: | :--------------------: | --------------------------- |\r\n\r\n| Nifty screening | Volume scanners | Breakout detection | Consolidating stocks | Reversal Signals |\r\n| :-------------: | :-------------: | :----------------: | :------------------: | ---------------- |\r\n\r\n| Chart Patterns | CCI scanners | 2% scanners | Short-term bulls | NR4 / NR7 | Weekly Releases |\r\n| :------------: | :----------: | :---------: | :--------------: | :-------: | --------------- |\r\n\r\n| Fair Value | Mutual funds, FII data | TTM Squeeze | Golden Crossover | Death Crossover |\r\n| :--------: | :--------------------: | :---------: | :--------------: | --------------- |\r\n\r\n| RSI screening | MACD scanners | IPO Stocks | Momentum Gainers | Watchlist screening |\r\n| :-----------: | :-----------: | :--------: | :--------------: | ------------------- |\r\n\r\n| Stock Performance | 52Wk H/L Breakouts | 10 days low breakouts | Aroon Crossover | Next Day Bullish Stocks |\r\n| :---------------: | :----------------: | :-------------------: | :-------------: | ----------------------- |\r\n\r\n| Today's Breakouts | Breaking out now | Popular stocks by Mutual Funds / FIIs | Higher Highs | Lower Lows |\r\n| :---------------: | :--------------: | :-----------------------------------: | :----------: | ---------- |\r\n\r\n| F&O Stocks screening | Live 5-EMA Index Scan | Logging | Telegram Channel | Early Breakouts |\r\n| :------------------: | :-------------------: | :-----: | :--------------: | --------------- |\r\n### A Python-based stock screener for NSE, India.\r\n\r\n**pkscreener** is an advanced stock screener to find potential breakout stocks from NSE and tell it's possible breakout values. It also helps to find the stocks which are consolidating and may breakout, or the particular chart patterns that you're looking specifically to make your decisions.\r\npkscreener is totally customizable and it can screen stocks with the settings that you have provided.\r\n\r\nYou can get daily scan results/alerts at scheduled times by subscribing to the following Telegram channel:\r\n|    Purpose     |                                                                                                                   Description/link                                                                                                                    | QR Code                                                                                                                                          |     |     |\r\n| :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------ | --- | --- |\r\n| Alerts Channel | https://t.me/PKScreener > You wil receive all the major alerts on this telegram channel. These alerts are sent for all major strategy scans daily around 9:30am-10:15am and then around 4pm. You will also receive the next day's market predictions. | <img src=\"https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/Telegram_Channel_Prod.jpg\" alt=\"Telegram Channel\" width=\"100\"/> |     |     |\r\n|                |                                                                                                                                                                                                                                                       |                                                                                                                                                  |     |     |\r\n\r\n![telegram](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/telegram.png)\r\n\r\n## Receiving Scheduled Scan results\r\nIf you would like to receive the scan results, please join the telegram channel and group above. \r\nYou may receive the following scan results:\r\n1. [![1. Next day Nifty/Market AI prediction](https://github.com/pkjmesra/PKScreener/actions/workflows/w4-workflow-prod-scans_1.yml/badge.svg)](https://github.com/pkjmesra/PKScreener/actions/workflows/w4-workflow-prod-scans_1.yml) by 4pm IST, Monday - Friday\r\n2. For all Nifty stocks at/by 9:45-10:15am and by 4pm IST, Monday - Friday\r\n\r\n   * Certain selected but configurable alerts for specific scan types\r\n\r\n## Receiving On-Demand Scan results\r\nYou can now run the `pkscreenerbot` on your local machine or if it's running on the GitHub server under a GitHub Actions workflow, you can use the `pkscreener Bot`(@nse_pkscreener_bot on Telegram) to get on-demand scan results.\r\n\r\n![bot](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/bot.gif)\r\n\r\n## Scanners\r\n\r\nScreening options to choose from:\r\n* Artificial Intelligence v2 for Nifty 50 Prediction\r\n* Live Index Scan : 5 EMA for Intraday\r\n* Screen stocks by the stock names (NSE Stock Code)\r\n* Nifty 50\r\n* Nifty Next 50\r\n* Nifty 100\r\n* Nifty 200\r\n* Nifty 500\r\n* Nifty Smallcap 50\r\n* Nifty Smallcap 100\r\n* Nifty Smallcap 250\r\n* Nifty Midcap 50\r\n* Nifty Midcap 100\r\n* Nifty Midcap 150\r\n* Nifty (All Stocks)\r\n* Newly Listed (IPOs in last 2 Year)\r\n* F&O Stocks Only\r\n* NASDAQ\r\n\r\nFollowin scanners are already implemented. Others are `In Progress`\r\n```\r\n0 > Full Screening (Shows Technical Parameters without any criterion)\r\n     1 > Probable Breakouts              \t2 > Today's Breakouts\r\n     3 > Consolidating stocks            \t4 > Lowest Volume in last 'N'-days (Early Breakout Detection)\r\n     5 > RSI screening                   \t6 > Reversal Signals\r\n     7 > Stocks making Chart Patterns    \t8 > CCI outside of the given range\r\n     9 > Volume gainers                  \t10 > Closing at least 2% up since last 3 days\r\n    11 > Short term bullish stocks(Intraday)\t12 > 15 Minute Price & Volume breakout(Intraday)\r\n    13 > Bullish RSI & MACD(Intraday)       \t14 > NR4 Daily Today\r\n    15 > 52 week low breakout(today/1 wk)\t16 > 10 days low breakout\r\n    17 > 52 week high breakout(today/1 wk)\t18 > Bullish Aroon(14) Crossover\r\n    19 > MACD Histogram x below 0       \t20 > Bullish for next day\r\n    21 > Most Popular Stocks            \t22 > View Stock Performance         \r\n    23 > Breaking out now               \t24 > Higher Highs,Lows & Close      \r\n    25 > Lower Highs,Lows (Watch for Reversal)            \t\r\n```\r\n## How to use on your own local Windows/Linux/Macbook laptop?\r\n\r\n# Using docker, running within docker container\r\n* Download and install docker desktop: https://docs.docker.com/get-docker/\r\n* After installation, launch/run docker desktop and if it asks, login using your docker credentials.\r\n* Launch any command line (for example, cmd on windows or terminal on Mac) and type `docker pull pkjmesra/pkscreener:latest`. Then type `docker run -it pkjmesra/pkscreener:latest`.  \r\n  The option `-i` will open the `pkscreener` in interactive mode within docker. `-t` will allocate a pseudo terminal for you so you can begin to use `pkscreener`\r\n\r\n# Installing the latest version from PyPi.\r\n* Go ahead and install using `pip install pkscreener`\r\n* This should install all of the major dependencies, except maybe, TA-Lib.\r\n* This app can still run without TA-Lib, but if you need to install TA-Lib for technical indicators (which otherwise is used from `pandas_ta` in the absence of TA-Lib), you can do this: Head to `.github/dependencies/` under this repo. Download the respective TA-Lib file/whl file and install either from the .whl file or from source. Check out any of the workflow files for steps to install TA-Lib.\r\n\r\nFor example:\r\n\r\nFor `Windows`: See https://github.com/pkjmesra/PKScreener/blob/c1e94ba3137915cb781161fa2d5fb69129940fd3/.github/workflows/w1-workflow-build-matrix.yml#L91-L101\r\n\r\nFor `Mac`: Run `brew install ta-lib` assuming you have homebrew installed.\r\n\r\nFor `Ubuntu/Linux`: See https://github.com/pkjmesra/PKScreener/blob/main/.github/workflows/w1-workflow-build-matrix.yml#L121-L132\r\n\r\n* Now launch your favorite command line CLI and issue `pkscreener`. This will launch the pkscreener executable.\r\n\r\n# Building from source repo\r\n* Install python 3.9 for your OS/CPU. Download the installer from https://www.python.org/downloads/release/python-3913/#Files\r\n* Just clone the repo with `git clone https://github.com/pkjmesra/PKScreener.git`\r\n* `cd PKScreener`\r\n* `pip install -r requirements.txt` .\r\n* (Optional) If you would like to have technical indicators evaluated using TA-Lib, go ahead and install TA-Lib as well. `pip3 install ta-lib`. Please review additional steps to buil TA-Lib in the workflow files meant for your OS under .github > workflows and follow the line numbers from the previous section.\r\n* `cd pkscreener`\r\n* Finally, from within the `pkscreener` directory, run `python pkscreenercli.py`. Or just type/run `pkscreener`. You are all set.\r\n\r\n# Running the executables\r\n* Download the suitable file according to your OS.\r\n* Linux & Mac users should make sure that the `pkscreenercli.bin or pkscreenercli.run` is having `execute` permission. (`chmod +x pkscreenercli.run`)\r\n\r\n* **Run** the file. Following window will appear.\r\n\r\n\r\n* **Configure** the parameters as per your requirement using `Option > E`.\r\n\r\n![config](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/config.png)\r\n\r\n* **Scanner Menus** the scanner menus for each level/sub-level\r\n  ![menulevel1](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu.png)\r\n  ![menulevel2](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu_level2.png)\r\n  ![menulevel3](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/menu_level3.png)\r\n\r\n\r\n* Following are the screenshots of screening and output results.\r\n\r\n![screening](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/screening.png)\r\n\r\nResults :\r\n\r\n![results](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/results.png)\r\n\r\nIt also shows you how the chosen scan option has fared in the past. 1-Pd, 2-Pd means 1 day, 2 days from the date of scan in the past when those stocks came into the results of the chosen scan option.\r\n\r\n![results](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/result_analysis.png)\r\n* Once done, you can also save the results in an excel file.\r\n\r\n## Growth of 10k\r\n\r\nYou can see the performance of your stocks and/or at portfolio level using \"Growth of 10k\".\r\n\r\n![G10k](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/G10k.png)\r\n\r\nIt also summarises the Growth of 10k at portfolio level for the last quarter so that you know which filters worked best in the past:\r\n\r\n![G10k_Sum](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/G10k_Sum.png)\r\n\r\n## Backtests\r\nYou can now use the *Backtests* menu to backtest any of the selected strategies. See https://pkjmesra.github.io/PKScreener/BacktestReports.html\r\n\r\n![backtest](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/backtest.png)\r\n\r\n* Once done, you can also view the output html file saved at the same location from where you launched the app.\r\n\r\n## Scanning as a scheduled job once or at regular intervals\r\n* Running it once with pre-defined inputs\r\n  You can also run it as a one time job in any scheduler with pre-defined options. For example `./pkscreenercli.py -a Y -o X:12:10 -e` (or `pkscreenercli.exe -a Y -o X:12:10 -e` if you're executing with the exe) will run the scanner for all Nifty stocks and find all stocks matching CCI filter, save the results in xlsx file and exit. `./pkscreenercli.py -a Y -o X:12:9:2.5 -e` will run the scanner (menu option `X`) for all Nifty stocks (menu option `12`) to find volume gainers (menu option `9`) with at least the volume multiplier of 2.5 (input variable `2.5`), save the results in xlsx file and exit (menu option `-e`). Passing in the `-p` option for example `pkscreenercli.py -a Y -p -o X:12:6:1 -e` will also silence all command line prints/outputs and just run silently for the given options, save results and exit. Try and see all options with `./pkscreenercli.py -h`.\r\n\r\n* Running it at regular intervals\r\n  If you want to runn it at regular intervals, you can just pass the interval in `-c` command line option. For example, `./pkscreenercli.py -a Y -o X:12:6:1 -c 180` will run it every `180` seconds with console outputs also being printed. If you'd just like it to run as a cron job without console outputs, you may also pass the `-p` parameter. For example, `./pkscreenercli.py -a Y -p -o X:12:6:1 -c 180`\r\n\r\n## Understanding the Result Table:\r\n\r\nThe Result table contains a lot of different parameters which can be pretty overwhelming to the new users, so here's the description and significance of each parameter.\r\n\r\n| Sr  |       Parameter       | Description                                                                                                                                                                                                                  | Example                                                                                  |\r\n| :-: | :-------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |\r\n|  1  |       **Stock**       | This is a NSE scrip symbol. If your OS/Terminal supports unicode, You can directly open **[TradingView](https://in.tradingview.com/)** charts by pressing `Ctrl+Click` on the stock name.                                    | [TATAMOTORS](https://in.tradingview.com/chart?symbol=NSE%3ATATAMOTORS)                   |\r\n|  2  |   **Consolidating**   | It gives the price range in which stock is trading since last `N` days. `N` is configurable and can be modified by executing `Edit User Configuration` option.                                                               | If stock is trading between price 100-120 in last 30 days, Output will be `Range:20.0 %` |\r\n|  3  | **Breakout (N Days)** | This is pure magic! The `BO` is Breakout level in last N days while `R` is the next resistance level if available. Investor should consider both BO & R level to decide entry/exits in their trades.                         | `B:302, R:313`(Breakout level is 100 & Next resistance is 102)                           |\r\n|  4  |        **LTP**        | LTP is the Last Traded Price of an asset traded on NSE.                                                                                                                                                                      | `298.7` (Stock is trading at this price)                                                 |\r\n|  5  |      **Volume**       | Volume shows the relative volume of the recent candle with respect to 20 period MA of Volume. It could be `Unknown` for newly listed stocks.                                                                                 | if 20MA(Volume) is 1M and todays Volume is 2.8M, then `Volume = 2.8x`                    |\r\n|  6  |     **MA-Signal**     | It describes the price trend of an asset by analysing various 50-200 MA/EMA crossover strategies.                                                                                                                            | `200MA-Support`,`BullCross-50MA` etc                                                     |\r\n|  7  |        **RSI**        | For the momentum traders, it describes 14-period RSI for quick decision making about their trading plans                                                                                                                     | `0 to 100`                                                                               |\r\n|  8  |       **Trend**       | By using advance algorithms, the average trendlines are computed for `N` days and their strenght is displayed depending on steepness of trendlines. (This does NOT show any trendline on chart, it is calculated internally) | `Strong Up`, `Weak Down` etc.                                                            |\r\n|  9  |      **Pattern**      | If the chart or the candle itself forming any important pattern in the recent timeframe or as per the selected screening option, various important patterns will be indicated here.                                          | `Momentum Gainer`, `Inside Bar (N)`,`Bullish Engulfing` etc.                             |\r\n\r\n## Hack it your way:\r\nFeel free to Edit the parameters in the `pkscreener.ini` file which will be generated by the application.\r\n```\r\n[config]\r\nperiod = 280d\r\ndaystolookback = 22\r\nduration = 1d\r\nminprice = 20.0\r\nmaxprice = 50000.0\r\nvolumeratio = 2.5\r\nconsolidationpercentage = 10.0\r\nshuffle = y\r\ncachestockdata = y\r\nonlystagetwostocks = y\r\nuseema = n\r\nshowunknowntrends = y\r\nlogsenabled = n\r\ngeneraltimeout = 2.0\r\nlongtimeout = 4.0\r\nmaxnetworkretrycount = 10\r\nbacktestperiod = 60\r\nminimumvolume = 10000\r\n```\r\nTry to tweak this parameters as per your trading styles. For example, If you're comfortable with weekly charts, make `duration=5d` and so on. For intraday, you can set `period=1d and duration=5m` if you would like to calculate with 5minute candles. Set the duration to `15m` or whatever value you desire, but keep the period to `1d`. This tool, however, works best for short/mid term instead of intraday, but some scans like momentum/volume/NR4 etc can be used for screening stocks for intraday as well. You can use the toggle menu option `T` to toggle between long term and intraday config before you begin the scanners.\r\n\r\n## Creating your own Telegram channel to receive your own alerts:\r\nYou can create your own telegram channel to receive alerts wherenevr you run it locally on your laptop either from a command line interface console or run it as a scheduler. Simply, go ahead and\r\n1. Create a bot for yourself, then a channel and get their IDs. Follow the steps in https://medium.com/codex/using-python-to-send-telegram-messages-in-3-simple-steps-419a8b5e5e2 and https://www.siteguarding.com/en/how-to-get-telegram-bot-api-token\r\n2. After you have created the bot using `botFather` and have received/verified your bot id/token and channel ID using `get id bot`, simply go to `pkscreener` folder in the source code directory and create a `.env.dev` file with the following (If you are instead using the .exe or .bin or .run file from release, just create this file in the same folder where the executable (.exe or .bin or .run) is placed.)\r\n```\r\nCHAT_ID=Your_Channel_Id_Here_Without_A_Hyphen_or_Minus_Sign\r\nTOKEN=Your_Bot_Token_Here\r\nchat_idADMIN=Your_Own_ID_Here\r\n```\r\n3. From now on, you will begin to receive your own alerts on your telegram channel.\r\n   ![alerts](https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/alerts.png)\r\n\r\n## Troubleshooting and Logs:\r\nIf you are having issues running the program, you can just launch a command line interface (On windows> Start > Run > cmd) and then launch PKScreener with a command line option of `-l`. For example, `python pkscreenercli.py -l`. This will show you the path where the program will save all the log outputs from this run. Copy that path and go ahead and run the application. Altenatively, you can just go ahead and modify the `logsEnabled` value to `y`, save & close it and then run `python pkscreenercli.py`.\r\n\r\nAfter you have finished the run, go to that copied path, zip the contents of the file `pkscreener-logs.txt` and create an issue at https://github.com/pkjmesra/PKScreener/issues. Please do not forget to attach the log files in the issue.\r\n\r\n## Contributing:\r\n* Please feel free to Suggest improvements bugs by creating an issue.\r\n* Please follow the [Guidelines for Contributing](https://github.com/pkjmesra/PKScreener/blob/main/CONTRIBUTING.md) while making a Pull Request.\r\n\r\n## Disclaimer:\r\n* DO NOT use the results provided by the software 'solely' to make your trading decisions.\r\n* Always backtest and analyze the stocks manually before you trade.\r\n* The Author(s), the software and any related/unrelated entity will not be held liable for your own investing decisions or losses. The authors or this softfware does not make any claim about the correctness of the results.\r\n* This screener began as a [fork](https://github.com/pranjal-joshi/Screeni-py) but has since added a lot of additional scanners, backtesting, Telegram bots, Alerts and a number of modifications and improvements.\r\n\r\n[MADE-IN-INDIA-badge]: https://img.shields.io/badge/MADE%20WITH%20%E2%9D%A4%20IN-INDIA-orange\r\n[MADE-IN-INDIA]: https://en.wikipedia.org/wiki/India\r\n[Windows-badge]: https://img.shields.io/badge/Windows-0078D6?logo=windows&logoColor=white\r\n[Windows]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.exe\r\n[Linux-badge]: https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black\r\n[Linux]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.bin\r\n[Mac OS-badge]: https://img.shields.io/badge/mac%20os-D3D3D3?logo=apple&logoColor=000000\r\n[Mac OS]: https://github.com/pkjmesra/PKScreener/releases/download/0.44.20240504.332/pkscreenercli.run\r\n[GitHub release (latest by date)-badge]: https://img.shields.io/github/v/release/pkjmesra/PKScreener\r\n[GitHub release (latest by date)]: https://github.com/pkjmesra/PKScreener/releases/latest\r\n[pypi-badge]: https://img.shields.io/pypi/v/pkscreener.svg?style=flat-square\r\n[pypi]: https://pypi.python.org/pypi/pkscreener\r\n[wheel-badge]: https://img.shields.io/pypi/wheel/pkscreener.svg?style=flat-square\r\n[GitHub all releases]: https://img.shields.io/github/downloads/pkjmesra/PKScreener/total?color=Green&label=Downloads&style=for-the-badge\r\n[License-badge]: https://img.shields.io/github/license/pkjmesra/PKScreener?style=for-the-badge\r\n[License]: https://github.com/pkjmesra/PKScreener/blob/main/LICENSE\r\n[Codefactor-badge]: https://www.codefactor.io/repository/github/pkjmesra/PKScreener/badge\r\n[Codefactor]: https://www.codefactor.io/repository/github/pkjmesra/PKScreener\r\n[PR-Guidelines-badge]: https://img.shields.io/badge/PULL%20REQUEST-GUIDELINES-red?style=for-the-badge\r\n[PR-Guidelines]: https://github.com/pkjmesra/PKScreener/blob/new-features/CONTRIBUTING.md\r\n[github-license]: https://img.shields.io/pypi/l/gspread?logo=github\r\n[Downloads-badge]: https://static.pepy.tech/personalized-badge/pkscreener?period=total&units=international_system&left_color=black&right_color=brightgreen&left_text=PyPi%20Downloads\r\n[Downloads]: https://pepy.tech/project/pkscreener\r\n[Latest-Downloads-badge]: https://img.shields.io/github/downloads-pre/pkjmesra/pkscreener/latest/total?logo=github\r\n[Coverage-Status-badge]: https://coveralls.io/repos/github/pkjmesra/PKScreener/badge.svg?branch=main\r\n[Coverage-Status]: https://coveralls.io/github/pkjmesra/PKScreener?branch=main\r\n[codecov-badge]: https://codecov.io/gh/pkjmesra/PKScreener/branch/main/graph/badge.svg\r\n[codecov]: https://codecov.io/gh/pkjmesra/PKScreener\r\n[Documentation-badge]: https://readthedocs.org/projects/pkscreener/badge/?version=latest\r\n[Documentation]: https://pkscreener.readthedocs.io/en/latest/?badge=latest\r\n[Docker Status-badge]: https://img.shields.io/docker/automated/pkjmesra/pkscreener.svg\r\n[Docker Status]: https://hub.docker.com/repository/docker/pkjmesra/pkscreener\r\n[Docker Pulls-badge]: https://img.shields.io/docker/pulls/pkjmesra/pkscreener.svg\r\n[Prod Scan Tests-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w5-workflow-prod-scans_Tests.yml/badge.svg\r\n[Prod Scan Tests]: https://github.com/pkjmesra/PKScreener/actions/workflows/w5-workflow-prod-scans_Tests.yml\r\n[After Market-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w9-workflow-download-data.yml/badge.svg\r\n[After Market]: https://github.com/pkjmesra/PKScreener/actions/workflows/w9-workflow-download-data.yml\r\n[New Features-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w10-workflow-features-test.yml/badge.svg\r\n[New Features]: https://github.com/pkjmesra/PKScreener/actions/workflows/w10-workflow-features-test.yml\r\n[New Release-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w1-workflow-build-matrix.yml/badge.svg\r\n[New Release]: https://github.com/pkjmesra/PKScreener/actions/workflows/w1-workflow-build-matrix.yml\r\n[Docker-Build-badge]: https://github.com/pkjmesra/PKScreener/actions/workflows/w15-docker-image.yml/badge.svg\r\n[Docker-Build]: https://github.com/pkjmesra/PKScreener/actions/workflows/w15-docker-image.yml\r\n\r\n<!-- [![Docker Build][Docker-Build-badge]][Docker-Build] [![PKScreener Test - New Features][New Features-badge]][New Features] [![w9. After-Market Data Gen][After Market-badge]][After Market] [![1. PKScreener Build - New Release][New Release-badge]][New Release] [![Documentation][Documentation-badge]][Documentation]\r\n\r\n[![GitHub all releases][GitHub all releases]](#) [![GitHub][License-badge]][License] [![BADGE][PR-Guidelines-badge]][PR-Guidelines]\r\n [![w5. Production Scan Tests On Dev][Prod Scan Tests-badge]][Prod Scan Tests] \r\n-->\r\n\r\n<!--      |                                                                                                                    Discussions []                                                                                                                     | https://t.me/PKScreeners > For any discussion related to PKScreener, you may like to join this related Telegram group                            | <img src=\"https://raw.githubusercontent.com/pkjmesra/PKScreener/main/screenshots/PKScreeners_Group.jpg\" alt=\"Telegram Group\" width=\"100\"/> | --> \r\n",
    "bugtrack_url": null,
    "license": "OSI Approved (MIT)",
    "summary": "A Python-based stock screener for NSE, India with alerts to Telegram Channel (pkscreener)",
    "version": "0.44.20240504.333",
    "project_urls": {
        "Download": "https://github.com/pkjmesra/pkscreener/archive/v0.44.20240504.333.zip",
        "Homepage": "https://github.com/pkjmesra/pkscreener"
    },
    "split_keywords": [
        "nse",
        " technical indicators",
        " scanning",
        " stock scanners"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8f906d2485ce0fa694a7f0e3d868fe4bfb63eca5794a994ef8ba774f9ec6aea7",
                "md5": "427ec9262a74a37df978085ca700b0fe",
                "sha256": "319aadd7ad1143fdb1b71d331339acde4b99c79e602605e87eeb064174edf84f"
            },
            "downloads": -1,
            "filename": "pkscreener-0.44.20240504.333-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "427ec9262a74a37df978085ca700b0fe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 657852,
            "upload_time": "2024-05-04T08:16:16",
            "upload_time_iso_8601": "2024-05-04T08:16:16.772565Z",
            "url": "https://files.pythonhosted.org/packages/8f/90/6d2485ce0fa694a7f0e3d868fe4bfb63eca5794a994ef8ba774f9ec6aea7/pkscreener-0.44.20240504.333-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4948d6d0d5b36be36bb650633c77591ab6dac505a3faa0713817983ad599fb06",
                "md5": "1812fcba104114a4ce87c4aca066729b",
                "sha256": "c19b41efd078c7eb1b6a06a87501b2cfba1f3c7f6b7d512f32d642e4393dd359"
            },
            "downloads": -1,
            "filename": "pkscreener-0.44.20240504.333.tar.gz",
            "has_sig": false,
            "md5_digest": "1812fcba104114a4ce87c4aca066729b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 642686,
            "upload_time": "2024-05-04T08:16:20",
            "upload_time_iso_8601": "2024-05-04T08:16:20.555150Z",
            "url": "https://files.pythonhosted.org/packages/49/48/d6d0d5b36be36bb650633c77591ab6dac505a3faa0713817983ad599fb06/pkscreener-0.44.20240504.333.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-04 08:16:20",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pkjmesra",
    "github_project": "pkscreener",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "pkscreener"
}
        
Elapsed time: 0.35667s