# National Stock Exchange of India — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track live NSE stock prices, monitor indices, analyze option chains, and access corporate announcements with real-time market data from India's National Stock Exchange. View equity quotes with full order books, identify top gainers/losers, analyze 52-week highs/lows, and explore historical price trends all in structured JSON format.

**Category:** Finance & Markets | **Website:** [nseindia.com/](https://nseindia.com/) | **Docs:** [parse.bot/marketplace/2a81eefa-a201-41f8-af3b-103a9010df01/nseindia-com-api](https://parse.bot/marketplace/2a81eefa-a201-41f8-af3b-103a9010df01/nseindia-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_52_week_high_low

Get stocks hitting 52-week highs or lows with previous high/low comparison. Returns count and data array of stocks at their yearly extremes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Set to 'high' for 52-week highs or 'low' for 52-week lows |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_52_week_high_low \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### get_all_indices

Get comprehensive data for all NSE indices (NIFTY 50, BANK NIFTY, etc.) including open, high, low, last, previousClose, and percentage change. Returns the full list of actively traded indices.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_all_indices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_corporate_announcements

Get corporate announcements and filings filterable by segment. Returns the latest announcements with submission details, attachment links, and company metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | Segment filter: 'equities', 'debt', 'sme' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_corporate_announcements \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>"}'
```

### get_equity_market_data

Get live market watch data for all stocks in a given index including last price, change, volume, and 30/365 day chart paths. The first item in the data array is the index summary itself.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | Index name (e.g., 'NIFTY 50', 'NIFTY BANK', 'NIFTY NEXT 50') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_equity_market_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>"}'
```

### get_financials

Get last 4 quarters of financial results (income statement summary) for a given NSE stock symbol. Returns quarterly total income, profit before tax, net profit after tax, and EPS as reported to the exchange. NSE provides income statement data only; balance sheet and cash flow are not available through this API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | NSE equity symbol (e.g. RELIANCE, TCS, INFY) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_financials \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_gainers_losers

Get top gainers or losers across various index groups. Returns data organized by index legends (NIFTY, BANKNIFTY, NIFTYNEXT50) and security size categories (SecGtr20, SecLwr20, FOSec, allSec).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | Set to 'gainers' for top gainers or 'loosers' for top losers |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_gainers_losers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>"}'
```

### get_historical_prices

Get historical OHLCV (open, high, low, close, volume) data for an NSE equity within a date range. Returns daily price records including VWAP, number of trades, and 52-week high/low. Maximum date range supported by NSE is approximately 1 year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_date` | string | Yes | Start date in DD-MM-YYYY format (e.g. '01-08-2026') |
| `symbol` | string | Yes | NSE equity symbol (e.g. RELIANCE, TCS, INFY) |
| `to_date` | string | Yes | End date in DD-MM-YYYY format (e.g. '18-08-2026') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_historical_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_date":"<string>","symbol":"<string>","to_date":"<string>"}'
```

### get_index_constituents

Get the list of constituent stocks in a given NSE index (e.g. NIFTY 50, NIFTY 100, NIFTY 200, NIFTY 500). Returns an array of stock objects with symbol, price data (OHLCV), 52-week range, and free-float market cap. Makes one upstream request regardless of index size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index_name` | string | No | NSE index name (e.g. 'NIFTY 50', 'NIFTY 100', 'NIFTY 200', 'NIFTY 500', 'NIFTY BANK') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_index_constituents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index_name":"<string>"}'
```

### get_index_names

Get a list of all available NSE index names. Returns two arrays: one in natural order and one sorted by name, each containing [index_code, index_name] pairs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_index_names \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_market_status

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_market_status \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_most_active_equities

Get most active equities by traded value or traded volume. Returns top stocks ranked by the chosen activity metric.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Activity type: 'value' for most active by traded value, 'volume' for most active by traded volume |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_most_active_equities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### get_option_chain

Retrieve the full option chain for a given symbol and expiry date. Returns all strike prices with Call (CE) and Put (PE) data including open interest, implied volatility, and Greeks. If expiry is not specified, uses the nearest available expiry.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `expiry` | string | No | Expiry date in DD-Mon-YYYY format (e.g., '16-Jun-2026'). If not provided, uses nearest expiry. |
| `symbol` | string | No | Symbol for the option chain (e.g., NIFTY, BANKNIFTY, RELIANCE) |
| `type` | string | No | Type of option chain: 'Indices' or 'Equity' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_option_chain \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expiry":"<string>","symbol":"<string>","type":"<string>"}'
```

### get_price_band_hitters

Get stocks hitting upper or lower price bands. Returns data categorized by upper, lower, and both band hitters with sub-categories by market cap (AllSec, SecGtr20, SecLwr20).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_price_band_hitters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_quote_equity

Get detailed quote for an individual equity symbol including order book (top 5 bids/asks), trade info (volume, value, delivery %), price info (52-week high/low, volatility), and security metadata (sector, industry, index membership).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | NSE equity symbol (e.g., RELIANCE, TCS, INFY) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_quote_equity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_securities_lending_borrowing

Get Securities Lending and Borrowing (SLB) live analysis data. Auto-detects the latest available series if not specified. The data array may be empty when no active SLB contracts exist for the selected series.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series` | string | No | SLB series code obtained from the master list. If not provided, automatically uses the first available series. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_securities_lending_borrowing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"series":"<string>"}'
```

### get_stock_quote

Get detailed stock quote for a single NSE equity symbol including OHLCV data, 52-week high/low, market capitalization, P/E ratio, sector, industry, and ISIN. Returns one object with comprehensive price and company metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | NSE equity symbol (e.g. RELIANCE, TCS, INFY) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_stock_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_stock_quotes

Get detailed stock quotes for multiple NSE equity symbols in one call. Accepts a comma-separated list of symbols (max 20) and returns combined OHLCV data, market cap, sector, and industry for each. Makes one upstream request per symbol. Symbols that fail individually are reported in the errors array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbols` | string | Yes | Comma-separated list of NSE equity symbols, max 20 (e.g. 'RELIANCE,TCS,INFY') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_stock_quotes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":"<string>"}'
```

### get_symbol_chart_data

Get intraday or historical chart data for an equity symbol. Returns timestamped price data points. Symbol must include the series suffix (e.g., RELIANCEEQN for equity normal).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | string | No | Time period: '1D' for intraday, '1M' for 1 month |
| `symbol` | string | Yes | NSE equity symbol with series suffix (e.g., RELIANCEEQN, TCSEQN). Format is <SYMBOL><SERIES>N where SERIES is typically 'EQ'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_symbol_chart_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<string>","symbol":"<string>"}'
```

### get_yearwise_data

Get performance summary (1 week, 1/3/6 month, 1/2/3/5 year changes) for a symbol compared with its benchmark index. Symbol must include series suffix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | NSE symbol with series suffix (e.g., RELIANCEEQN, TCSEQN). Format is <SYMBOL><SERIES>N where SERIES is typically 'EQ'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/get_yearwise_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### search_stock

Search for NSE-listed stocks by company name or symbol. Returns up to 10 matching results with company name, NSE symbol, ISIN, and series. Makes one metadata lookup per result to resolve ISIN codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword - company name or symbol (e.g. 'Reliance', 'TCS', 'HDFC') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/search_stock \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_symbols

Search for equity symbols and companies by keyword. Returns matching equities with symbol, company name, series, and quote page URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'Reliance', 'TCS', 'HDFC') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nseindia-com-api-2a81eefa/search_symbols \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```