NSEPython Documentation

First Initialize it -

from nsepython import *

Printing Indicies -


The Output will show -


1 Like

Getting the FNO List -


The Output will show -


Getting Option Chain Data -


The Output will show a huge JSON data. You can use https://jsonformatter.org/json-viewer to navigate through the data schema.

The oi_chain_builder Function



  • symbol = FNO Symbol
  • expiry = “latest” (By default) or, You can choose next expiry by typing the expiry dates like “30-Jul-2020”
  • oi_mode = “full” (By default) or “compact” (It will fetch all options info).


  • oi_data = It will be a Pandas Dataframe.
  • ltp = LTP of the symbol
  • crontime = Data’s Updation Time as per NSE Server when fetched

oi_data, ltp, crontime = oi_chain_builder("PVR","latest","full")
oi_data, ltp, crontime = oi_chain_builder("NIFTY")

it only shows “{}” when executed in powershell. Does powershell not show json?

The latter one makes a dictionary I suppose. Shows error that no such file or directory: oi_data/TATASTEEL.pickle.

Pickle is a module installed by python by default, so idk why the error.

Sometimes NSE site get crapped and genuinely give {}. That might be one reason.
Regarding Powershell, I never tried it.

NIFTY total OI and Change in oi columns got from nsepython is not matching with actual data in nse (All other columns are matching except toi and coi)


please check the attached screenshot

https://www1.nseindia.com/ and https://www.nseindia.com/ gives two different output.

Like, Lets say if we take BankNIFTY. One will show number of lots like 10 (Lets assume) while another will show in number of qty like 10*20=200.

Obviously www1 site will depreciate! Right?

Its not matching with both the old and new websites.

All three are screenshots taken almost close time


But how that will be possible. You can see my code too. You may be fetching in local mode from pickle? Instead of live?

oi_data, ltp, crontime = oi_chain_builder(“NIFTY”,“latest”,“full”,“fetch”)
Iam just using the oi_data received from this method

Then God knows…Check my code. It is just scrapping from NSE only. See if you can spot any mistake there.


Finally found whats wrong…U have hardcoded the multiplication of oi by 20. If it’s only Banknifty data scrapper it was fine but for others, it gives wrong OI and Change in OI :face_with_head_bandage:

Fixed it. Also wrote your name in code as Thank you Gesture.

  1. Fixed the OI problem as mentioned here. NSEPython Documentation
  2. Added ATM Strike Function as mentioned here - Getting the ATM strikes for all the FNO stocks
  3. Removed Pickle as suggested by everyone.

Getting live quotes for stocks using stock codes.

There are two types of APIs that fetch info in NSE.


Equity API and Derivatives API fetches the structure in a different manner. You can just paste their output to a website like jsonformatter.org/json-viewer and study.


You can also alternatively use quote_equity() function instead of nse_eq().
You can also alternatively use quote_derivative() function instead of nse_fno().

This first function will paste the output from the Equity API and the second function will paste the output from Derivatives API.

Stocks API

To get LTP of any stock, You need to do this -

For Open, High, Low, Clsoe, You need to do this -

You can also find things like sector’s PE or sector’s name of which the stock belong -

Derivatives API

To get LTP of any derivative’s underlying, You need to do this -

These APIs show a very detailed level of data. You need to explore yourself using the JSON formats. If there is any significant stuff, I may create a separate functions for it later on.

You can also alternatively use option_chain() function instead of nse_optionchain_scrapper() .

Also, Added one dumb function -

def running_status(): 
    start_now=datetime.datetime.now().replace(hour=9, minute=15, second=0, microsecond=0)
    end_now=datetime.datetime.now().replace(hour=15, minute=45, second=0, microsecond=0)
    return start_now<datetime.datetime.now()<end_now

Just do running_status(). It will give true if the market is running and false if the market is not running.

The Holiday API

There are two types -

Here is how to use the function

or, holiday_master(type)

type = trading or clearing. By default, trading will be selected.

Here is how to see the holidays of FNOs -


The Results API


The API looks like this -


index has three types:

  • equities
  • debt
  • sme

period has four types:

  • Quarterly
  • Annual
  • Half-Yearly
  • Others



Default Value of index is equities and period is Quarterly in nse_results() function.

Example Usage: