Metadata-Version: 2.1
Name: nse
Version: 0.1.1.post1
Summary: Unofficial Python Api for NSE India stock exchange
Project-URL: Homepage, https://github.com/BennyThadikaran/NseIndiaApi
Project-URL: Bug Tracker, https://github.com/BennyThadikaran/NseIndiaApi/issues
Author: Benny Thadikaran
License-File: LICENSE
Keywords: nse,nse-stock-data,stock-market-api,stock-news-api
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mthrottle>=0.0.1
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# :moneybag: NseIndiaApi

An unofficial Python API for the NSE India stock exchange.

Python version: >= 3.10

If you ❤️ my work so far, please 🌟 this repo.

## :alien: Documentation
[https://bennythadikaran.github.io/NseIndiaApi](https://bennythadikaran.github.io/NseIndiaApi)

## :fire: Usage

**Install with Pip**
```bash
pip install -U nse
```

The class accepts a single argument `download_folder`, a `str` filepath, or a `pathlib object`. The folder stores cookie and any downloaded files.

**Simple example**
```python
from nse import NSE
from pathlib import Path

# Working directory
DIR = Path(__file__).parent

nse = NSE(download_folder=DIR)

status = nse.status()

advDec = nse.advanceDecline()

nse.exit() # close requests session
```

**Using with statement**

```python
with NSE(download_folder=DIR) as nse:
    status = nse.status()

    advDec = nse.advanceDecline()
```

## Samples folder

The `src/samples` folder contains sample outputs of various methods. The filenames match the method names. The output has been truncated in some places but demonstrates the overall structure of responses.
