Indian Stock Market Data API

Query NSE and BSE prices, company fundamentals, financial results and shareholding from a script or an AI client. The DocStoX financial data API uses Model Context Protocol (MCP) with JSON-RPC over Streamable HTTP and requires authentication.

Available financial data

Company financials
get_financials
Quarterly and annual revenue, net profit, EPS and available fundamental ratios.
Historical stock prices
get_price_history
Historical price candles and volume by symbol and exchange.
Shareholding patterns
get_shareholding
Quarter-end promoter, institutional and public ownership where reported.
Stock screening
screen_stocks
Filter the market using valuation, growth, profitability and other supported metrics.
Company news
get_stock_news_feed
Recent company coverage and events linked to a ticker.

Data history and completeness vary by instrument and reporting period. See market coverage and data freshness.

Example request for annual company financials

Connect your MCP client to https://mcp.docstox.com/mcp. For scripts, load your key from an environment variable and send it as a Bearer token. After the client initializes the connection, use the tool call below for the latest three annual periods available for Reliance Industries.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_financials",
    "arguments": {
      "symbol": "RELIANCE",
      "period_type": "A",
      "report_type": "Consolidated",
      "periods": 3
    }
  }
}

Check period_end_date and report_type in the response before comparing periods. The default reporting basis can fall back to standalone filings when consolidated filings are unavailable.

See plan limits and tool access, or connect an AI app.