RuchiTanmay / nselib

nse data library
Apache License 2.0
50 stars 32 forks source link

NSElib 1.0

Python Library to get publicly available data on new NSE india website.

Release Notes

Libraries Required

For Windows systems you can install Anaconda, this will cover many dependencies (You'll have to install requests and beautifulsoup additionally though)

Installation

Fresh installation

$pip install nselib

Upgrade

$pip install nselib --upgrade

Function list

nselib

Example :

import nselib

data = nselib.trading_holiday_calendar()

Capital Market

Example :

from nselib import capital_market

data = capital_market.price_volume_and_deliverable_position_data(symbol='SBIN', from_date='01-06-2023', to_date='10-06-2023')

OR

data = capital_market.price_volume_and_deliverable_position_data(symbol='SBIN', period='1M')

More functions will be available in future releases...

Derivative

Example :

from nselib import derivatives

data = derivatives.future_price_volume_data(symbol='SBIN', instrument='FUTSTK', from_date='01-06-2023', to_date='10-06-2023')

OR

data = derivatives.price_volume_and_deliverable_position_data(symbol='BANKNIFTY', instrument='FUTIDX', period='1M')

Note: instrument type ( future index = FUTIDX, future stocks = FUTSTK, option index = OPTIDX, option stocks = OPTSTK)

More functions will be available in future releases...

Debt

More functions will be available in future releases...

How can I contribute?

There are multiple ways in which you can contribute-

Write about your project

There are working on to add many function to this library. NSElib at the moment is short of good documentation. There are lot of features in NSElib yet to come :( , so till we complete the documentation, I'll need support from the community.

Please write about your projects in blogs, quora answers and other forums, so that people find working examples to get started.

Raising issues, bugs, enhancement requests

For quick resolution please raise issues both here on issue page. I'll try my best to address the issues quickly on github as and when I get notified, but raising it on stackoverflow will provide you access to a larger group and someone else might solve your problem before I do.

Submit patches

If you have fixed an issue or added a new feature, please fork this repository, make your changes and submit a pull request. Here's good article on how to do this.

Looking forward for healthy participation from community.