Indian Stock Market API - NSE & BSE Real-Time Data

Free REST API for fetching real-time stock prices from both NSE (National Stock Exchange) and BSE (Bombay Stock Exchange) of India. Perfect for automation tools like n8n, Make, Zapier, Node-RED, trading bots, and financial applications.

Base URL: http://65.0.104.9/

Version: 2.4

License: MIT

Features

• Free and open-source Indian stock market API
• Support for both NSE and BSE exchanges
• Real-time stock market data
• No authentication or API key required
• RESTful JSON API
• Flexible response formats (numeric or with units)
• Smart search with company name
• Automatic exchange detection
• Batch stock queries
• Indian number formatting (Crores/Lakhs)

Exchange Support

NSE (National Stock Exchange)

• Suffix: .NS
• Default: Yes (used when no suffix provided)
• Examples: ITC.NS, RELIANCE.NS, TCS.NS

BSE (Bombay Stock Exchange)

• Suffix: .BO
• Default: No (must specify suffix)
• Examples: ITC.BO, RELIANCE.BO, TCS.BO

Usage Pattern

ITC        → Fetches from NSE (default)
ITC.NS     → Fetches from NSE (explicit)
ITC.BO     → Fetches from BSE

API Endpoints

1. Search for Stocks

Find stock symbols by searching with company names.

Endpoint: GET /search?q={query}

Parameters:

• q (required): Search query (company name or symbol)

Examples:

GET /search?q=reliance
GET /search?q=tata
GET /search?q=hdfc bank
GET /search?q=indian oil

Sample Response:

{
  "status": "success",
  "query": "reliance",
  "total_results": 1,
  "results": [
    {
      "symbol": "RELIANCE",
      "company_name": "Reliance Industries Limited",
      "match_type": "exact",
      "source": "cache",
      "api_url": "/stock?symbol=RELIANCE",
      "nse_url": "/stock?symbol=RELIANCE.NS",
      "bse_url": "/stock?symbol=RELIANCE.BO"
    }
  ],
  "note": "Add .NS for NSE or .BO for BSE to the symbol. Default is NSE.",
  "timestamp": "2025-10-18 18:29:00"
}

---

2. Get Single Stock Details

Retrieve detailed information for a specific stock.

Endpoint: GET /stock?symbol={SYMBOL}&res={num|val}

Parameters:

• symbol (required): Stock symbol with optional exchange suffix
• res (optional): Response format - num (numbers only) or val (with units). Default: val

Example 1: NSE Stock - Default (No Suffix)

GET /stock?symbol=ITC&res=num

Sample Response:

{
  "status": "success",
  "symbol": "ITC",
  "exchange": "NSE",
  "ticker": "ITC.NS",
  "response_format": "numeric_only",
  "data": {
    "company_name": "ITC Limited",
    "last_price": 445.5,
    "change": 2.3,
    "percent_change": 0.52,
    "previous_close": 443.2,
    "open": 444.0,
    "day_high": 447.8,
    "day_low": 442.5,
    "year_high": 490.0,
    "year_low": 380.25,
    "volume": 52345670,
    "market_cap": 5567894500000.0,
    "pe_ratio": 28.45,
    "dividend_yield": 3.45,
    "book_value": 156.5,
    "earnings_per_share": 15.65,
    "sector": "Consumer Defensive",
    "industry": "Tobacco",
    "currency": "INR",
    "last_update": "2025-10-18",
    "timestamp": "2025-10-18 18:29:00"
  },
  "alternate_exchange": {
    "exchange": "BSE",
    "ticker": "ITC.BO",
    "api_url": "/stock?symbol=ITC.BO"
  }
}

Example 2: NSE Stock - Explicit Suffix

GET /stock?symbol=RELIANCE.NS&res=num

Sample Response:

{
  "status": "success",
  "symbol": "RELIANCE",
  "exchange": "NSE",
  "ticker": "RELIANCE.NS",
  "response_format": "numeric_only",
  "data": {
    "company_name": "Reliance Industries Limited",
    "last_price": 2456.75,
    "change": 12.3,
    "percent_change": 0.5,
    "previous_close": 2444.45,
    "open": 2450.0,
    "day_high": 2468.9,
    "day_low": 2445.2,
    "year_high": 2856.0,
    "year_low": 2220.3,
    "volume": 8234567,
    "market_cap": 16645678900000.0,
    "pe_ratio": 27.35,
    "dividend_yield": 0.35,
    "book_value": 892.4,
    "earnings_per_share": 89.75,
    "sector": "Energy",
    "industry": "Oil & Gas Integrated",
    "currency": "INR",
    "last_update": "2025-10-18",
    "timestamp": "2025-10-18 18:29:00"
  },
  "alternate_exchange": {
    "exchange": "BSE",
    "ticker": "RELIANCE.BO",
    "api_url": "/stock?symbol=RELIANCE.BO"
  }
}

Example 3: BSE Stock

GET /stock?symbol=TCS.BO&res=num

Sample Response:

{
  "status": "success",
  "symbol": "TCS",
  "exchange": "BSE",
  "ticker": "TCS.BO",
  "response_format": "numeric_only",
  "data": {
    "company_name": "Tata Consultancy Services Limited",
    "last_price": 3456.75,
    "change": -12.5,
    "percent_change": -0.36,
    "previous_close": 3469.25,
    "open": 3465.0,
    "day_high": 3478.9,
    "day_low": 3445.2,
    "year_high": 4078.0,
    "year_low": 3011.3,
    "volume": 1234567,
    "market_cap": 12678945000000.0,
    "pe_ratio": 29.35,
    "dividend_yield": 1.45,
    "book_value": 245.8,
    "earnings_per_share": 117.65,
    "sector": "Technology",
    "industry": "Information Technology Services",
    "currency": "INR",
    "last_update": "2025-10-18",
    "timestamp": "2025-10-18 18:29:00"
  },
  "alternate_exchange": {
    "exchange": "NSE",
    "ticker": "TCS.NS",
    "api_url": "/stock?symbol=TCS.NS"
  }
}

Example 4: With Units (res=val)

GET /stock?symbol=INFY.NS&res=val

Sample Response:

{
  "status": "success",
  "symbol": "INFY",
  "exchange": "NSE",
  "ticker": "INFY.NS",
  "response_format": "values_with_units",
  "data": {
    "company_name": "Infosys Limited",
    "last_price": {
      "value": 1567.8,
      "unit": "INR"
    },
    "change": {
      "value": 8.9,
      "unit": "INR"
    },
    "percent_change": {
      "value": 0.57,
      "unit": "%"
    },
    "previous_close": {
      "value": 1558.9,
      "unit": "INR"
    },
    "open": {
      "value": 1560.0,
      "unit": "INR"
    },
    "day_high": {
      "value": 1572.5,
      "unit": "INR"
    },
    "day_low": {
      "value": 1556.3,
      "unit": "INR"
    },
    "year_high": {
      "value": 1953.9,
      "unit": "INR"
    },
    "year_low": {
      "value": 1351.65,
      "unit": "INR"
    },
    "volume": {
      "value": 3.46,
      "unit": "Crores Shares"
    },
    "market_cap": {
      "value": 654321.0,
      "unit": "Crores INR"
    },
    "pe_ratio": {
      "value": 24.56,
      "unit": "x"
    },
    "dividend_yield": {
      "value": 2.15,
      "unit": "%"
    },
    "book_value": {
      "value": 312.45,
      "unit": "INR"
    },
    "earnings_per_share": {
      "value": 63.85,
      "unit": "INR"
    },
    "sector": "Technology",
    "industry": "Information Technology Services",
    "currency": "INR",
    "last_update": "2025-10-18",
    "timestamp": "2025-10-18 18:29:00"
  },
  "alternate_exchange": {
    "exchange": "BSE",
    "ticker": "INFY.BO",
    "api_url": "/stock?symbol=INFY.BO"
  }
}

---

3. Get Multiple Stocks

Retrieve information for multiple stocks in one request. Mix NSE and BSE symbols.

Endpoint: GET /stock/list?symbols={SYMBOL1,SYMBOL2}&res={num|val}

Parameters:

• symbols (required): Comma-separated stock symbols
• res (optional): Response format - num or val. Default: val

Example 1: Multiple NSE Stocks (Default)

GET /stock/list?symbols=ITC,TCS,INFY&res=num

Sample Response:

{
  "status": "success",
  "response_format": "numeric_only",
  "count": 3,
  "stocks": [
    {
      "symbol": "ITC",
      "exchange": "NSE",
      "ticker": "ITC.NS",
      "company_name": "ITC Limited",
      "last_price": 445.5,
      "change": 2.3,
      "percent_change": 0.52,
      "volume": 52345670,
      "market_cap": 5567894500000.0,
      "pe_ratio": 28.45,
      "sector": "Consumer Defensive"
    },
    {
      "symbol": "TCS",
      "exchange": "NSE",
      "ticker": "TCS.NS",
      "company_name": "Tata Consultancy Services Limited",
      "last_price": 3456.75,
      "change": -12.5,
      "percent_change": -0.36,
      "volume": 1234567,
      "market_cap": 12678945000000.0,
      "pe_ratio": 29.35,
      "sector": "Technology"
    },
    {
      "symbol": "INFY",
      "exchange": "NSE",
      "ticker": "INFY.NS",
      "company_name": "Infosys Limited",
      "last_price": 1567.8,
      "change": 8.9,
      "percent_change": 0.57,
      "volume": 34567890,
      "market_cap": 6543210000000.0,
      "pe_ratio": 24.56,
      "sector": "Technology"
    }
  ],
  "timestamp": "2025-10-18 18:29:00"
}

Example 2: Multiple BSE Stocks

GET /stock/list?symbols=ITC.BO,RELIANCE.BO,HDFCBANK.BO&res=num

Sample Response:

{
  "status": "success",
  "response_format": "numeric_only",
  "count": 3,
  "stocks": [
    {
      "symbol": "ITC",
      "exchange": "BSE",
      "ticker": "ITC.BO",
      "company_name": "ITC Limited",
      "last_price": 445.35,
      "change": 2.15,
      "percent_change": 0.49,
      "volume": 48234560,
      "market_cap": 5565678900000.0,
      "pe_ratio": 28.42,
      "sector": "Consumer Defensive"
    },
    {
      "symbol": "RELIANCE",
      "exchange": "BSE",
      "ticker": "RELIANCE.BO",
      "company_name": "Reliance Industries Limited",
      "last_price": 2456.5,
      "change": 12.05,
      "percent_change": 0.49,
      "volume": 7834567,
      "market_cap": 16642345600000.0,
      "pe_ratio": 27.33,
      "sector": "Energy"
    },
    {
      "symbol": "HDFCBANK",
      "exchange": "BSE",
      "ticker": "HDFCBANK.BO",
      "company_name": "HDFC Bank Limited",
      "last_price": 1645.75,
      "change": -5.25,
      "percent_change": -0.32,
      "volume": 5678901,
      "market_cap": 12456789000000.0,
      "pe_ratio": 19.85,
      "sector": "Financial Services"
    }
  ],
  "timestamp": "2025-10-18 18:29:00"
}

Example 3: Mixed NSE and BSE Stocks

GET /stock/list?symbols=ITC.NS,RELIANCE.BO,TCS.NS,INFY.BO&res=num