# NSE India Market Data API
> Live market data from the National Stock Exchange of India (NSE), with no key. Read the live value of every NSE index (NIFTY 50, BANK NIFTY, NIFTY NEXT 50 and the rest) with open/high/low, day change and 52-week range; check the open/close status of each market segment; pull the day's top gainers and losers for any index group; and read the most-active securities by traded value or volume. The Indian-equities / stock-index / market-movers layer for trading dashboards, screeners, fintech and research — distinct from US-stock and FX-rate readers. Live from NSE; short cache only.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nseindia-api/..."
```

## Pricing
- **Free** (Free) — 22,000 calls/Mo, 3 req/s
- **Starter** ($14/Mo) — 440,000 calls/Mo, 8 req/s
- **Pro** ($43/Mo) — 2,200,000 calls/Mo, 20 req/s
- **Enterprise** ($108/Mo) — 11,000,000 calls/Mo, 60 req/s

## Endpoints

### Market

#### `GET /v1/index` — A single NSE index by name

**Parameters:**
- `name` (query, required, string) — Index name, e.g. NIFTY 50, BANK NIFTY Example: `NIFTY 50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/index?name=NIFTY+50"
```

**Response:**
```json
{
    "data": {
        "note": "One NSE index by name — last value, open/high/low, previous close, day change and 52-week range. Pass name (e.g. NIFTY 50, BANK NIFTY).",
        "index": {
            "low": 23313.9,
            "high": 23645.35,
            "last": 23622.9,
            "open": 23412.55,
            "index": "NIFTY 50",
            "symbol": "NIFTY 50",
            "year_low": 22182.55,
            "variation": 461.3,
            "year_high": 26373.2,
            "percent_change": 1.99,
            "previous_close": 23161.6
        },
        "source": "NSE India",
        "timestamp": "12-Jun-2026 15:30"
    },
    "meta": {
        "timestamp": "2026-06-15T02:11:18.032Z",
        "request_id": "37243f9d-88d0-4d71-b680-a8b6e95a877e"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

#### `GET /v1/indices` — Live value of every NSE index

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/indices"
```

**Response:**
```json
{
    "data": {
        "note": "The live value of every NSE index — NIFTY 50, BANK NIFTY, NIFTY NEXT 50 and the rest — each with last, open, high, low, previous close, day change and 52-week high/low. The headline pulse of the Indian equity market.",
        "count": 139,
        "source": "NSE India",
        "indices": [
            {
                "low": 23313.9,
                "high": 23645.35,
                "last": 23622.9,
                "open": 23412.55,
                "index": "NIFTY 50",
                "symbol": "NIFTY 50",
                "year_low": 22182.55,
                "variation": 461.3,
                "year_high": 26373.2,
                "percent_change": 1.99,
                "previous_close": 23161.6
            },
            {
                "low": 68947.4,
                "high": 70080.95,
                "last": 70007.2,
                "open": 69318.2,
                "index": "NIFTY NEXT 50",
                "symbol": "NIFTY NEXT 50",
                "year_low": 59896.1,
                "variation": 1628.45,
                "year_high": 72442.15,
                "percent_change": 2.38,
                "previous_close": 68378.75
            },
            {
                "low": 55726.55,
                "high": 56867.1,
                "last": 56814.8,
                "open": 55934.1,
                "index": "NIFTY BANK",
                "symbol": "NIFTY BANK",
                "year_low": 49954.85,
                "variation": 1638
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/market-status` — Open/close status of each segment

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/market-status"
```

**Response:**
```json
{
    "data": {
        "note": "The open/close status of each NSE market segment (Capital Market, Currency, Commodity, Debt) with its reference index level. Check whether the Indian market is trading right now.",
        "count": 5,
        "source": "NSE India",
        "markets": [
            {
                "last": 23622.9,
                "index": "NIFTY 50",
                "market": "Capital Market",
                "status": "Open",
                "variation": 461.3000000000029,
                "trade_date": "12-Jun-2026 15:30",
                "percent_change": 1.99
            },
            {
                "last": null,
                "index": null,
                "market": "Currency",
                "status": "Open",
                "variation": null,
                "trade_date": "15-Jun-2026",
                "percent_change": null
            },
            {
                "last": null,
                "index": null,
                "market": "Commodity",
                "status": "Open",
                "variation": null,
                "trade_date": "15-Jun-2026",
                "percent_change": null
            },
            {
                "last": null,
                "index": null,
                "market": "Debt",
                "status": "Open",
                "variation": null,
                "trade_date": "15-Jun-2026",
                "percent_change": null
            },
            {
                "last": 95.22,
              
…(truncated, see openapi.json for full schema)
```

### Movers

#### `GET /v1/most-active` — Most-active securities

**Parameters:**
- `by` (query, optional, string) — value or volume (default value) Example: `value`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/most-active?by=value"
```

**Response:**
```json
{
    "data": {
        "by": "value",
        "note": "The most-active securities on NSE by traded value or volume — each with its last price, day change, quantity traded and total traded value. Pass by=value or by=volume. The day's busiest Indian stocks.",
        "count": 20,
        "source": "NSE India",
        "securities": [
            {
                "symbol": "MTARTECH",
                "last_price": 7147,
                "percent_change": 13.34,
                "previous_close": 6306,
                "quantity_traded": 4307470,
                "total_traded_value": 30280264933.7,
                "total_traded_volume": 4307470
            },
            {
                "symbol": "HDFCBANK",
                "last_price": 771.95,
                "percent_change": 3.67,
                "previous_close": 744.6,
                "quantity_traded": 36088159,
                "total_traded_value": 27587954029.14,
                "total_traded_volume": 36088159
            },
            {
                "symbol": "ICICIBANK",
                "last_price": 1340,
                "percent_change": 1.75,
                "previous_close": 1317,
                "quantity_traded": 18339846,
                "total_traded_value": 24447014718,
                "total_traded_volume": 18339846
            },
            {
                "symbol": "AEGISLOG",
                "last_price": 943,
                "percent_change": 1.85,
                "previous_close": 925.9,
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/movers` — Top gainers or losers

**Parameters:**
- `direction` (query, optional, string) — gainers or losers (default gainers) Example: `gainers`
- `group` (query, optional, string) — NIFTY, BANKNIFTY, NIFTYNEXT50, FOSec, allSec… Example: `NIFTY`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/movers?direction=gainers&group=NIFTY"
```

**Response:**
```json
{
    "data": {
        "note": "The day's top gainers or losers on NSE for an index group — each with its last price, open/high/low, net and percent change, traded quantity and turnover. Pass direction (gainers|losers) and group (NIFTY, BANKNIFTY, NIFTYNEXT50, FOSec, allSec…).",
        "count": 20,
        "group": "NIFTY",
        "source": "NSE India",
        "direction": "gainers",
        "timestamp": "12-Jun-2026 16:00:00",
        "securities": [
            {
                "low": 901.6,
                "ltp": 958,
                "high": 959.1,
                "open": 908,
                "series": "EQ",
                "symbol": "SHRIRAMFIN",
                "turnover": 90920.4600032,
                "net_change": 8.1,
                "percent_change": 8.1,
                "previous_price": 886.25,
                "trade_quantity": 9760441
            },
            {
                "low": 881.1,
                "ltp": 920,
                "high": 921,
                "open": 881.2,
                "series": "EQ",
                "symbol": "BAJFINANCE",
                "turnover": 105679.61681280001,
                "net_change": 5.68,
                "percent_change": 5.68,
                "previous_price": 870.55,
                "trade_quantity": 11729668
            },
            {
                "low": 3921,
                "ltp": 4050,
                "high": 4059.8,
                "open": 3930,
                "series": "EQ",
                "symbo
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Endpoints, groups & source

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nseindia-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "nifty50": 23622.9
        },
        "source": "NSE India public site API (nseindia.com/api), keyless",
        "service": "nseindia-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/index": "A single index by name (name).",
            "GET /v1/movers": "Top gainers or losers (direction, group).",
            "GET /v1/indices": "Live value of every NSE index.",
            "GET /v1/most-active": "Most-active securities (by=value|volume).",
            "GET /v1/market-status": "Open/close status of each market segment."
        },
        "description": "Live market data from the National Stock Exchange of India with no key: every NSE index value (NIFTY 50, BANK NIFTY…), market-segment open/close status, the day's top gainers and losers, the most-active securities by value or volume, and a single index lookup. The Indian-equities / stock-index / market-movers layer for trading dashboards, screeners and fintech. Distinct from US-stock and FX-rate readers. Live, short cache only.",
        "mover_groups": [
            "NIFTY",
            "BANKNIFTY",
            "NIFTYNEXT50",
            "SecGtr20",
            "SecLwr20",
            "FOSec",
            "allSec"
        ],
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:11:19.221Z",
        "request_id": "ced33426-ccc4-457e-9209-c502e646e10d"
    },
    "status": "ok",
    "message": "Me
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/nseindia-api
OpenAPI spec: https://www.oanor.com/api/nseindia-api/openapi.json
