NSE India APInseindia.com ↗
Access live NSE equity quotes, option chains, indices, gainers/losers, 52-week highs, and corporate announcements via a structured JSON API.
What is the NSE India API?
This API exposes 15 endpoints covering live data from India's National Stock Exchange, including equity quotes with full order books, real-time option chains, index-level market watch, and corporate announcements. The get_option_chain endpoint returns complete CE/PE strike data with open interest and volume totals, while get_quote_equity delivers priceInfo, tradeInfo, metaData, and orderBook for any NSE-listed symbol.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d621017b-ba03-43b8-816b-e5167cb6ec16/get_market_status' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nseindia-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""NSE India API – bounded walkthrough of core market-data operations."""
from parse_apis.nse_india_api import (
NSE, ActivityType, Segment, Index2, SymbolNotFound,
)
client = NSE()
# 1. List all NSE indices – capped to 5 items.
for idx in client.indexes.list(limit=5):
print(idx.index_name, idx.last, idx.perc_change)
# 2. Get a detailed equity quote by symbol.
try:
quote = client.equityquotes.get(symbol="RELIANCE")
print(quote.company_name, quote.change, quote.p_change, quote.year_high)
except SymbolNotFound as exc:
print(f"Symbol not found: {exc.symbol}")
# 3. Search for symbols matching a keyword.
result = client.searchresults.search(query="HDFC", limit=3).first()
if result:
print(result.symbol, result.company_name, result.series)
# 4. Most active stocks by traded value.
for stock in client.stocks.most_active(type=ActivityType.VALUE, limit=3):
print(stock.symbol, stock.last_price, stock.total_traded_value)
# 5. Corporate announcements in the equities segment.
ann = client.announcements.list(segment=Segment.EQUITIES, limit=3).first()
if ann:
print(ann.symbol, ann.company_name, ann.description, ann.date)
# 6. Top gainers data.
gainers = client.gainerloserdatas.get(index=Index2.GAINERS)
print(gainers.legends)
print("exercised: indexes.list / equityquotes.get / searchresults.search / stocks.most_active / announcements.list / gainerloserdatas.get")
Get current market status across segments (Capital Market, Currency, Commodity, Debt) including market cap and GIFT Nifty data. Returns one object per market segment with its open/closed state, last trade date, and index values where applicable.
No input parameters required.
{
"type": "object",
"fields": {
"giftnifty": "object with GIFT Nifty futures data (LASTPRICE, DAYCHANGE, PERCHANGE, EXPIRYDATE)",
"marketcap": "object with market capitalization data (timeStamp, marketCapinTRDollars, marketCapinLACCRRupees, marketCapinCRRupees)",
"marketState": "array of market segment status objects with market name, marketStatus, tradeDate, index, last, variation, percentChange"
},
"sample": {
"data": {
"giftnifty": {
"DAYCHANGE": -40,
"LASTPRICE": 23140,
"PERCHANGE": -0.17,
"EXPIRYDATE": "30-Jun-2026"
},
"marketcap": {
"timeStamp": "10-Jun-2026",
"marketCapinTRDollars": 4.79,
"marketCapinLACCRRupees": 455.55
},
"marketState": [
{
"last": 23214.95,
"index": "NIFTY 50",
"market": "Capital Market",
"tradeDate": "10-Jun-2026 15:30",
"variation": -27.15,
"marketStatus": "Open",
"percentChange": -0.12,
"marketStatusMessage": "Normal Market has Closed"
}
],
"indicativenifty50": {
"change": -27.17,
"status": "CLOSE",
"perChange": -0.12,
"closingValue": 23214.95
}
},
"status": "success"
}
}About the NSE India API
Market Status and Index Data
The get_market_status endpoint returns segment-level status for Capital Market, Currency, Commodity, and Debt markets, along with GIFT Nifty futures data and total market capitalization in both rupees and dollars. get_all_indices lists every NSE index with open, high, low, last price, previous close, percent change, and 52-week high/low. Index names and their category-grouped codes are available via get_index_names, which returns two arrays: nts in natural order and stn sorted alphabetically.
Equity Quotes and Option Chains
get_quote_equity accepts a symbol parameter (e.g., RELIANCE, TCS) and returns an equityResponse array with nested orderBook, priceInfo, tradeInfo, secInfo, and metaData objects. For derivatives, get_option_chain accepts an optional type (Indices or Equity), symbol, and expiry in DD-Mon-YYYY format. When expiry is omitted, the nearest available expiry is used automatically. The records object includes all CE/PE strike data, expiry dates, and strike prices; the filtered object provides aggregated open interest and volume totals for each side.
Market Screeners and Activity Data
get_equity_market_data accepts an index name such as NIFTY 50 or NIFTY BANK and returns live price and volume data for every constituent stock, plus an index-level metadata summary. get_gainers_losers accepts gainers or loosers as the index parameter and returns ranked results for NIFTY 50 and BANK NIFTY with timestamps. get_price_band_hitters categorizes upper and lower circuit stocks by market cap (AllSec, SecGtr20, SecLwr20) with counts per category. get_52_week_high_low returns new52WHL, prev52WHL, last traded price, and percent change for each qualifying stock.
Chart and Performance Data
get_symbol_chart_data returns intraday or monthly price series via the days parameter (1D or 1M). The symbol must include a series suffix, for example RELIANCEEQN. The grapthData field contains arrays of [timestamp_ms, price, market_phase] tuples. get_yearwise_data uses the same symbol format and returns percent changes across 1 week, 1 month, 3 month, 6 month, and 1/2/3/5 year horizons for both the symbol and its benchmark index.
The NSE India API is a managed, monitored endpoint for nseindia.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nseindia.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nseindia.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Building an options analytics dashboard using strike-level CE/PE open interest from
get_option_chain - Monitoring real-time circuit breakers by polling
get_price_band_hittersfor upper and lower band hitters - Screening 52-week breakout candidates with
new52WHLandprev52WHLvalues fromget_52_week_high_low - Constructing a market-breadth tracker using gainers/losers counts across NIFTY 50 and BANK NIFTY
- Displaying intraday price charts with market-phase annotations from
grapthDatainget_symbol_chart_data - Alerting on corporate announcements by segment (equities, debt, SME) via
get_corporate_announcements - Comparing a stock's 1-year and 3-year performance against its index using
get_yearwise_data
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NSE India have an official developer API?+
What does `get_option_chain` return and how do I select a specific expiry?+
records object with all CE and PE strikes for the requested symbol, including expiryDates, strikePrices, open interest, change in OI, implied volatility, and volume. Pass expiry in DD-Mon-YYYY format (e.g., 12-May-2026) to target a specific expiry. Omitting expiry defaults to the nearest available date. The filtered object summarises total CE and PE open interest and volume across the selected expiry.Why does `get_symbol_chart_data` require a series suffix on the symbol?+
<SYMBOL><SERIES>N, so RELIANCE equity becomes RELIANCEEQN. Passing just RELIANCE will not resolve. Index names are not supported by this endpoint; use get_all_indices for index-level data.Does the API cover historical end-of-day OHLCV data or only intraday and monthly periods?+
get_symbol_chart_data currently supports 1D (intraday) and 1M (one month) via the days parameter. Longer historical time series (e.g., 1 year or multi-year daily OHLCV) are not currently covered. You can fork this API on Parse and revise it to add an endpoint targeting longer historical ranges.Is Securities Lending and Borrowing data always populated?+
get_securities_lending_borrowing endpoint's data array may be empty when no active SLB contracts exist for the selected series. The meta field identifies the series month-year (e.g., Apr-2027), and marketStatus indicates whether the SLB segment is open or closed. If you don't supply a series code, the endpoint auto-selects the first available series from its master list.