Python-NSE-Option-Chain-Analyzer - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #android #rust #deep-learning #linux #nodejs #awesome #kubernetes #security #mcp #open-source

Python-NSE-Option-Chain-Analyzer

(★ 654)

The NSE has a website which displays the option chain in near real-time. This program retrieves this data from the NSE site and then generates useful analysis of the Option Chain for the specified Index or Stock. It also continuously refreshes the Option Chain and visually displays the trend in various indicators useful for Technical Analysis.

파일 탐색기

최종 버전 다운로드 (.zip)

CHANGELOG.md
LICENSE
nse_logo.ico
nse_logo.png
NSE_Option_Chain_Analyzer.py
README.md
requirements.txt

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/VarunS2002/Python-NSE-Option-Chain-Analyzer

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Python-NSE-Option-Chain-Analyzer

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Python

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

- `apt install python3-pip`

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img width="128" height="128" src="https://i.imgur.com/OGHZnUu.png" alt="icon_square">

# Python-NSE-Option-Chain-Analyzer

## [Downloads](https://github.com/VarunS2002/Python-NSE-Option-Chain-Analyzer/releases)

[![Latest: v5.8](https://img.shields.io/badge/release-v5.8-brightgreen)](https://github.com/VarunS2002/Python-NSE-Option-Chain-Analyzer/releases/download/5.8/NSE_Option_Chain_Analyzer_5.8.exe)
![Download-Count](https://img.shields.io/github/downloads/VarunS2002/Python-NSE-Option-Chain-Analyzer/total?color=blue)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

For doing technical analysis for option traders, the Option Chain is the most important tool for deciding entry and exit
strategies. The National Stock Exchange (NSE) has a website which displays the option chain for traders in near
real-time. This program retrieves this data from the NSE site and then generates useful analysis of the Option Chain for
the specified Index or Stock. It also continuously refreshes the Option Chain and visually displays the trend in various
indicators useful for Technical Analysis. Calculations are based
on [Mr. Sameer Dharaskar's Course](http://advancesharetrading.com/).

## [Changelog](https://github.com/VarunS2002/Python-NSE-Option-Chain-Analyzer/blob/master/CHANGELOG.md)

## Disclaimer:

> #### This software is an unofficial software and is not affiliated with / endorsed or approved by the National Stock Exchange (NSE) or Mr. Sameer Dharaskar in any way
>
>#### This is purely an enthusiast program intended for educational purposes only and is not financial advice
>
>#### By downloading this software you acknowledge that you are using this at your own risk and that I am is not responsible for any damages that may occur to you due to the usage or installation of this program
>
>#### All NSE name/symbols are owned by the National Stock Exchange

## Installation:

> ### Supported platforms:

- Windows
- Linux
- macOS

> #### Method 1 (Windows only):

- Download the `.exe` (Windows Executable) file

- Run it directly

> #### Method 2:

- Requirements:
    - Python 3.6+
    - Additional steps for Linux:
        - `apt-get install python3-tk`
        - `apt install python3-pip`
    - For Windows and macOS https://www.python.org/downloads/ is recommended

- Download the `.py` (Python Source Code) file

- Required
  modules: [requirements.txt](https://github.com/VarunS2002/Python-NSE-Option-Chain-Analyzer/blob/master/requirements.txt)

- Install missing modules using `pip install -r requirements.txt`

> #### Note: Alternate implementations of Python and/or alternate methods of installation may also be supported

## Usage:

1. Set Index Mode or Stock Mode

2. Select your Index or Stock

3. Select it's Expiry Date

4. Enter your preferred Strike Price

5. Set the interval you want the program to refresh (Optional : Defaults to 1 minute)

6. Click Start

## Notes:

- If there is an error in fetching dates on login screen then try refreshing

- If there is an error in fetching dates on main screen then try stopping and again starting from option menu

- If you face any issue or have a suggestion then feel free to open an issue.

- It is recommended to enable logging and then send the `NSE-OCA.log` file or the console output for reporting issues

- In case of network or connection errors the program doesn't crash and will keep retrying until manually stopped

- If a `ZeroDivisionError` occurs or some data doesn't exist the value of the variable will be defaulted to `0`

- Set `load_nse_icon` option to `False` in the configuration file to prevent downloading the NSE icon in the `.py`
  version to speed up loading time

- If an `Incorrect Strike Price` error message is displayed and the strike price you entered is correct then check
  whether the NSE website is loading the data properly before creating an issue

## Features:

- The program continuously retrieves and refreshes the option chain giving near real-time analysis to the traders

- New data rows are added only if the NSE server updates its time or data (To prevent displaying duplicate data)

- Supported Indices and
  Stocks: https://www.nseindia.com/products-services/equity-derivatives-list-underlyings-information

- Option Chain data source: https://www.nseindia.com/option-chain

- Supports multiple instances with different indices/stocks and/or strike prices selected

- Red and Green colour indication for data based on trends

- Toast Notifications for notifying when trend changes (Windows 10 and 11 only). Notified changes:
    * Open Interest: Bullish/Bearish
    * Open Interest Upper Boundary Strike Prices: Change in Value
    * Open Interest Lower Boundary Strike Prices: Change in Value
    * Call Exits: Yes/No
    * Put Exits: Yes/No
    * Call ITM: Yes/No
    * Put ITM: Yes/No

- Program title format: `NSE-Option-Chain-Analyzer - {index/stock} - {expiry_date} - {strike_price}`

- Stop and Start manually

- You can select all table data using Ctrl+A or select individual cells, rows and columns

- Then you can copy it using Ctrl+C or right click menu

- You can then paste it in any spreadsheet application (Tested with MS Excel and Google Sheets)

- Export table data to `.csv` file

- Real time exporting data rows to `.csv` file

- Dumping entire Option Chain data to a `.csv` file

- Auto stop the program at 3:30pm when the market closes

- Alert if the last time the data from the server was updated is 5 minutes or more

- Auto Checking for updates

- Debug Logging

- Saves certain settings in a configuration file for subsequent runs. Saved Settings:
    * Load App Icon
    * Index/Stock Mode
    * Selected Index
    * Selected Stock
    * Refresh Interval
    * Live Export
    * Notifications
    * Dump entire Option Chain
    * Auto stop at 3:30pm
    * Warn Late Server Updates
    * Auto Check for Updates
    * Debug Logging

- Keyboard shortcuts for all options

## Data Displayed

> #### Table Data:

| Data                   | Description                                                                                                                                                                                                                                                                             |
|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Server Time            | Indicates last data update time by NSE server                                                                                                                                                                                                                                           |
| Value                  | Underlying Instrument Value indicates the value of the underlying Security or Index                                                                                                                                                                                                     |
| Call Sum               | Calculated. Sum of the Changes in Call Open Interest contracts of the given Strike Price and the next immediate two Strike Prices (In Thousands for Index Mode and Tens for Stock Mode)                                                                                                 |
| Put Sum                | Calculated. Sum of the Change in Put Open Interest contracts of the given Strike Price and the next two Strike Prices (In Thousands for Index Mode and Tens for Stock Mode)                                                                                                             |
| Difference             | Calculated. Difference between the Call Sum and Put Sum. If it's very -ve it's bullish, if it's very +ve then it's bearish else it's a sideways session.                                                                                                                                |
| Call Boundary          | Change in Call Open Interest contracts for 2 Strike Prices above the given Strike Price. This is used to determine if Call writers are taking new positions (Bearish) or exiting their positions (Bullish). (In Thousands for Index Mode and Tens for Stock Mode)                       |
| Put Boundary           | Change in Put Open Interest for the given Strike Price. This is used to determine if Put writers are taking new positions (Bullish) or exiting their positions(Bearish). (In Thousands for Index Mode and Tens for Stock Mode)                                                          |
| Call In The Money(ITM) | This indicates that bullish trend could continue and Value could cross 4 Strike Prices above given Strike Price. It's calculated as the ratio of Put writing and Call writing at the 4th Strike Price above the given Strike price. If the absolute ratio > 1.5 then it's bullish sign. |
| Put In The Money(ITM)  | This indicates that bearish trend could continue and Value could cross 2 Strike Prices below given Strike Price. It's calculated as the ratio of Call writing and Put writing at the 2nd Strike Price below the given Strike price. If the absolute ratio > 1.5 then it's bearish sign. |

> #### Label Data:

| Data                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                 |
|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Open Interest Upper Boundary | Highest and 2nd Highest(highest in OI boundary range) Call Open Interest contracts (In Thousands for Index Mode and Tens for Stock Mode) and their corresponding Strike Prices                                                                                                                                                                                                                                              |
| Open Interest Lower Boundary | Highest and 2nd Highest(highest in OI boundary range) Put Open Interest contracts (In Thousands for Index Mode and Tens for Stock Mode) and their corresponding Strike Prices                                                                                                                                                                                                                                               |
| Open Interest                | This indicates if the latest OI data record indicates Bearish or Bullish signs near Indicated Strike Price. If the Call Sum is more than the Put Sum then the OI is considered Bearish as there is more Call writing than Puts. If the Put Sum is more than the Call sum then the OI Is considered Bullish as the Put writing exceeds the Call writing.                                                                     |
| Put Call Ratio(PCR)          | Sum Total of Put Open Interest contracts divided by Sum Total of Call Open Interest contracts                                                                                                                                                                                                                                                                                                                               |
| Call Exits                   | This indicates if the Call writers are exiting near given Strike Price in the latest OI data record. If the Call sum is < 0 or if the change in Call OI at the Call boundary (2 Strike Prices above the given Strike Price) is < 0, then Call writers are exiting their positions and the Bulls have a clear path.                                                                                                          |
| Put Exits                    | This indicates if the Put writers are exiting near given Strike Price in the latest OI data record. If the Put sum is < 0 or if the change in Put OI at the Put boundary (the given Strike Price) is < 0, then Put writers are exiting their positions and the Bears have a clear path.                                                                                                                                     |
| Call In The Money(ITM)       | This indicates if the Call writers are also exiting far OTM strike prices (4 Strike Prices above the given Strike Price) showing extreme bullishness. Conditions are if the Call writers are exiting their far OTM positions and the Put writers are writing at the same Strike Price & if the absolute ratio > 1.5 then it's bullish sign. This signal also changes to Yes if the change in Call OI at the far OTM is < 0. |
| Put In The Money(ITM)        | This indicates if the Put writers are also exiting far OTM strike prices (2 Strike Prices below the given Strike Price) showing extreme bearishness. Conditions are if the Put writers are exiting their far OTM positions and the Call writers are writing at the same Strike Price & if the absolute ratio > 1.5 then it's a bearish sign. This signal also changes to Yes if the change in Put OI at the far OTM is < 0. |

## Screenshots:

- Login Page:

<br>![Login_Window](https://i.imgur.com/x3leqmZ.png) <br><br>

- Main Window Index Mode:

<br>![Main_Window_Index](https://i.imgur.com/ZFQCxCK.png) <br><br>

- Main Window Stock Mode:

<br>![Main_Window_Stock](https://i.imgur.com/qd8CLol.png) <br><br>

- Selecting Data:

<br>![Selecting_Data](https://i.imgur.com/zOjptS2.png) <br><br>

- Option Menu:

<br>![Option_Menu](https://i.imgur.com/CocgjbN.png) <br><br>

- Toast Notifications (Windows 10 and 11 only):

<br>![Notification](https://i.imgur.com/d3Fokxo.png) <br><br>

## Dependencies:

- [auto-py-to-exe](https://pypi.org/project/auto-py-to-exe/) is used for compiling the program to a .exe file

- [pandas](https://pypi.org/project/pandas/) is used for storing and manipulating the data

- [requests](https://pypi.org/project/requests/) is used for accessing and retrieving data from the NSE website

- [brotli](https://pypi.org/project/brotli/) is used for decoding data received from the NSE website

- [stream-to-logger](https://pypi.org/project/streamtologger/) is used for debug logging

- [tksheet](https://pypi.org/project/tksheet/) is used for the table containing the data

- [win10toast](https://pypi.org/project/win10toast/) is used for toast notifications on Windows 10 and 11

## Contributors:

- [medknecth](https://github.com/medknecth/)

- [Sangram2905](https://github.com/Sangram2905/)

- [yjagota](https://github.com/yjagota/)

- [QuickLearner171998](https://github.com/QuickLearner171998/)

- [chettyrajesh](https://github.com/chettyrajesh/)