Skip to main content

A Python library for accessing data from the National Stock Exchange (NSE) of India.

Project description

PNSEA - Python NSE API

Overview

PNSEA is a Python library for fetching data from the National Stock Exchange of India (NSE). It provides easy access to stock market data, options chains, insider trading reports, mutual fund data, and more.

Features

  • Fetch real-time equity data (CMP, historical data, market status, etc.).
  • Get insider trading reports, pledged data, and SAST data.
  • Retrieve option chain data for stocks and indices.
  • Fetch mutual fund insider data.
  • Autocomplete search queries for NSE symbols.
  • Endpoint tester for API debugging.

Installation

pip install pnsea

Usage

Initialize the NSE Instance

from pnsea import NSE

nse = NSE()

Fetch Equity Data

# Get current market price of SBIN
print(nse.equity.info("SBIN")['priceInfo']['lastPrice'])

# Fetch historical data
print(nse.equity.history("ESCORTS", "01-02-2025", "14-02-2025"))

# Get market status
print(nse.equity.market_status())

Fetch Insider Trading Data

# Get general insider trading data
print(nse.insider.insider_data())

# Get insider trading data with date range
print(nse.insider.insider_data(from_date="11-12-2023", to_date="14-02-2025"))

# Get insider trading data for a specific company
print(nse.insider.insider_data("SBIN"))

# Get insider trading data for a specific company with date range
print(nse.insider.insider_data("INFY", from_date="11-12-2023", to_date="14-02-2025"))

# Get pledged data for a single company
print(nse.insider.getPledgedData("ESCORTS"))

# Get SAST data for a single company
print(nse.insider.getSastData("ESCORTS"))

# Get SAST data for a single company with date range
print(nse.insider.getSastData("INFY", from_date="01-01-2024", to_date="01-02-2025"))

Options Expiry Dates

# All expiries from symbol
print(nse.options.expiry_dates("NIFTY"))

Fetch Option Chain Data

# Get option chain for NIFTY - all data
print(nse.options.option_chain("NIFTY")[0])

# Get option chain for NIFTY - by expiry date
print(nse.options.option_chain("NIFTY", expiry_date="06-Mar-2025")[0])

# Get option chain for NIFTY - by strike price
print(nse.options.option_chain("NIFTY", strike_price=22000)[0])

# Get option chain for NIFTY - by expiry date & strike price
print(nse.options.option_chain("NIFTY", expiry_date="06-Mar-2025", strike_price=22000)[0])

# Get option chain for NIFTY - All Expiries
print(nse.options.option_chain("NIFTY")[1])

# Get option chain for NIFTY - Underlying Value
print(nse.options.option_chain("NIFTY")[2])

Fetch Mutual Fund Data

#Get mutual fund insider data with date range
print(nse.mf.mf_insider_data(from_date="01-02-2025", to_date="02-02-2025"))

#Get mutual fund insider data by ISIN
print(nse.mf.mf_insider_data(isin="INF879O01027"))

#Get mutual fund insider data by symbol
print(nse.mf.mf_insider_data(symbol="PPFAS Mutual Fund"))

Autocomplete Search

# Search for NSE symbols
print(nse.autocomplete("Info"))

Author

Written by Anil Sardiwal

License

MIT License

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page