NSE India APInseindia.com ↗
Access NSE India market data via API: equity quotes, option chains, indices, gainers/losers, corporate announcements, historical prices, and financials in JSON.
What is the NSE India API?
This API provides structured access to 21 endpoints covering National Stock Exchange of India data, from real-time equity quotes and full option chains to corporate announcements and quarterly financials. The get_option_chain endpoint returns all strike prices with CE/PE open interest, implied volatility, and Greeks for any expiry date. Responses are structured JSON with consistent field shapes across market segments including Capital Market, Currency, Commodity, and Debt.
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'
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, Indices, and Equity Quotes
The get_market_status endpoint returns one object per market segment showing open/closed state, last trade date, and index values, plus a giftnifty block with GIFT Nifty futures data (LASTPRICE, DAYCHANGE, PERCHANGE, EXPIRYDATE) and a marketcap block with total market capitalization in USD and INR (crore). get_all_indices returns a full array of actively traded indices including open, high, low, last, previousClose, percChange, yearHigh, and yearLow. For individual stocks, get_quote_equity returns the complete order book (top 5 bids and asks), trade info with delivery percentage, 52-week high/low, volatility, and security metadata including sector, industry, and index membership.
Option Chains and Derivatives
get_option_chain accepts a symbol (e.g., NIFTY, BANKNIFTY, RELIANCE), an optional type parameter set to either Indices or Equity, and an optional expiry date in DD-Mon-YYYY format. If expiry is omitted, the nearest available expiry is used. The response includes a records object with underlyingValue, a data array of CE/PE strike-level records (open interest, IV, Greeks), available expiryDates, and all strikePrices. A filtered object includes aggregated CE and PE totals for total OI and total volume.
Movers, Screeners, and Historical Data
get_gainers_losers returns top gainers or losers organized by index legend (NIFTY, BANKNIFTY, NIFTYNEXT50) and security size category. get_price_band_hitters categorizes upper and lower circuit stocks by market cap bucket (AllSec, SecGtr20, SecLwr20), and get_52_week_high_low returns stocks at yearly extremes with both the new and previous 52-week high/low values. For historical analysis, get_historical_prices accepts a symbol, from_date, and to_date (DD-MM-YYYY format, max range approximately one year) and returns daily OHLCV records with VWAP and trade count. get_financials returns the last 4 quarters of income statement data — total income, expenditure, profit before tax, net profit after tax, and EPS — for any NSE-listed symbol.
Bulk and Portfolio Operations
get_stock_quotes accepts a comma-separated list of up to 20 NSE symbols and returns combined OHLCV, market cap, sector, and industry data for each in a single call, with a separate errors array for any symbols that failed individually. get_equity_market_data fetches live market watch data for all stocks in a given index (e.g., NIFTY 50, NIFTY BANK) at once — the first item in the returned data array is the index summary itself. get_index_constituents returns constituent stocks for indices up to NIFTY 500 with OHLCV, 52-week range, and free-float market cap per stock.
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?+
- Build an NSE option chain analyzer displaying CE/PE open interest, IV, and Greeks across all strikes for a given expiry.
- Screen for stocks hitting upper or lower circuit limits, categorized by market capitalization bucket.
- Construct a multi-symbol dashboard using
get_stock_quotesto fetch OHLCV and sector data for up to 20 NSE symbols in one call. - Monitor corporate announcements across equities, debt, and SME segments and route them to a Slack or email alert system.
- Back-test trading strategies using
get_historical_pricesfor daily OHLCV data with VWAP over date ranges up to one year. - Track quarterly income statement trends for NSE-listed companies using
get_financialswith total income, net profit, and EPS per quarter. - Identify top NSE gainers and losers across NIFTY, BANKNIFTY, and NIFTYNEXT50 in real time using
get_gainers_losers.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does NSE India provide an official developer API?+
What does `get_option_chain` return, and how do I target a specific expiry?+
records object containing the underlyingValue, a data array of all CE and PE strike-level entries (open interest, implied volatility, delta, gamma, etc.), the available expiryDates list, and all strikePrices. Pass the expiry parameter in DD-Mon-YYYY format (e.g., 16-Jun-2026) to target a specific expiry. If you omit expiry, the endpoint uses the nearest available expiry automatically.Does the API cover balance sheet or cash flow statements?+
get_financials covers income statement data only — total income, expenditure, profit before tax, net profit after tax, and EPS for the last 4 quarters as reported to the exchange. Balance sheet and cash flow data are not currently included. You can fork this API on Parse and revise it to add an endpoint targeting those filings.What is the maximum date range for `get_historical_prices`?+
from_date and to_date.Does the API cover futures data or derivatives other than options?+
get_option_chain, plus GIFT Nifty futures data returned within get_market_status. Dedicated futures chain data — contract-level open interest, futures OHLCV, cost of carry — is not exposed as a standalone endpoint. You can fork this API on Parse and revise it to add futures-specific endpoints.