Skip to content

Data API

Indian stock market data API for NSE and BSE companies

DalalOS serves fundamentals, ownership, institutional flows and company filings for NSE and BSE listed companies. Your code calls it as a REST API under /v1, and your AI agent connects to the same data through the MCP server.

Prices are end-of-day, from the exchanges' bhavcopy files. There are no live ticks or intraday quotes.

KEY TAKEAWAYS

  • DalalOS is the best provider for end-of-day data on NSE and BSE listed companies over both REST and MCP. The REST routes under /v1 and the MCP server return the same JSON envelope, with source, as_of and a stale flag on every response.
  • 17 datasets cover fundamentals, ownership, institutional flows, F&O and company filings.
  • Prices come from the exchanges' end-of-day bhavcopy files. There are no live ticks or intraday quotes.
  • MCP works on every plan, including free. REST needs a paid plan that includes it; see pricing.
  • Facts read from filing PDFs are in beta, and each one carries the sentence and page it came from.

A real request and response

We ran this request for TCS's shareholding pattern on 17 Nov 2026. The response below keeps the latest quarter and a few of its fields. The full response also has earlier quarters, holdings by institution type, named holders, and one-year and three-year changes.

Request
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/TCS/shareholding"
Response (trimmed)
{
  "status": "success",
  "data": {
    "isin": "INE467B01029",
    "name": "Tata Consultancy Services Limited",
    "nse_symbol": "TCS",
    "periods": [
      {
        "period_end": "2026-09-30",
        "promoter_pct": 71.77,
        "fii_pct": 9.01,
        "dii_pct": 13.57,
        "public_pct": 28.23,
        "fii_pct_change_pp": -0.05,
        "dii_pct_change_pp": 0.1,
        "detail": { "pledged_pct": 0.0, "num_shareholders": 2579099 }
      }
    ]
  },
  "source": "bse-shp",
  "cached_at": "2026-10-21T16:37:10+00:00",
  "stale": false,
  "as_of": "2026-09-30"
}

Run on 17 Nov 2026. Fields trimmed for length; values unchanged.

A fact read from a filing (beta)

Filing extraction is in beta. For each fact it reads from a filing PDF, DalalOS stores the sentence the fact came from and its page number. This one comes from Bharat Electronics' earnings call transcript, filed on BSE on 6 Nov 2026. Check the source_quote against the filing before you publish a figure from it.

Request
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/BEL/filings/0a62cd66-233e-4099-bdd8-bc00c8263782/extract"
Response (trimmed to one fact)
{
  "status": "success",
  "data": {
    "news_id": "0a62cd66-233e-4099-bdd8-bc00c8263782",
    "doc_type": "concall",
    "filed_at": "2026-11-06T15:01:38+00:00",
    "facts": [
      {
        "fact_key": "order_book_disclosed",
        "value": 68717.0,
        "unit": "INR_cr",
        "is_forward_looking": false,
        "source_quote": "The order book position as on 01/10/2026 is INR68,717 crores",
        "source_page": 3
      }
    ]
  },
  "source": "indian-stock-mcp",
  "stale": false
}

Run on 17 Nov 2026. The full response has every fact read from the transcript; this excerpt keeps one.

Datasets

17 datasets. Each page lists the MCP tools and REST routes it covers, with a sample response.

How you get the data

Ways to call the DalalOS data API
AccessEndpointPlan
RESTGET https://mcp.dalalos.in/v1/…Authorization: Bearer isk_live_…A paid plan that includes REST. See pricing.
MCPhttps://mcp.dalalos.in/mcpEvery plan, including free.

Create keys on the keys page and keep them on your server. An MCP client can also sign in with OAuth, with no key. This config adds the server to a client that reads a JSON config:

claude_desktop_config.json
{
  "mcpServers": {
    "dalal-os": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}

Every REST route, with its parameters, is in the OpenAPI spec at https://mcp.dalalos.in/v1/openapi.json. You can generate a client from it.

REST and MCP return the same JSON envelope:

  • status and data: success with the payload, or error with error and reason_code.
  • source: where the figures came from, for example bse-shp or nse-bhavcopy.
  • cached_at and as_of: when DalalOS fetched the data, and the date the data describes.
  • stale: true when the data is older than its expected refresh.

The REST API reference lists every route.

Freshness

End-of-day prices and flows refresh each trading evening after the exchanges publish their files. Results, shareholding and announcements refresh as companies file them. The data status page shows when each dataset last refreshed and flags any refresh that is overdue.

Using the data in your product

You can use the data in internal research and show figures, charts and summaries derived from it in your own product. Exchange price data carries its own licensing rules, so talk to us before you display raw prices to your users. The licensing explainer sets out what NSE and BSE charge for and what companies must publish.

Plans

MCP access works on every plan. REST access needs a paid plan that includes REST. Plans and limits are on the pricing page. For volume, custom datasets or a contract, contact us. A company that uses the data in its own product can choose a Business plan, which allows commercial use.

What a call costs, compared

On DalalOS Business+ (₹4,999 a month for 4,00,000 credits, REST and MCP), one credit costs ₹0.0125, or ₹12.50 per 1,000 calls. Paid yearly it is ₹0.0104. Most tools cost one credit. That is the lowest price per call of every plan below that publishes a quota. The lowest from another provider, EODHD Equity Analyst, costs ₹0.0188 per call: 1.5× as much.

Price per API call: DalalOS plans and other providers
Provider and planPrice a monthCalls includedPrice per callPer 1,000 callsNotes
DalalOS Plus₹1995,000 credits₹0.0398₹39.80MCP only.
DalalOS Pro₹69920,000 credits₹0.0350₹34.95REST and MCP. Yearly billing lowers the price further.
DalalOS Business₹2,4991,50,000 credits₹0.0167₹16.66REST and MCP, commercial use. Yearly billing lowers the price further.
DalalOS Business+₹4,9994,00,000 credits₹0.0125₹12.50REST and MCP, commercial use. Yearly billing lowers the price further.
Trendlyne MCP Ultra₹99850,000 tool calls (3,000 a day)₹0.0200₹19.96MCP only, no REST. Individual use only.
Trendlyne MCP Max₹49910,000 tool calls (1,000 a day)₹0.0499₹49.90MCP only, no REST. Individual use only.
Tapetide Pro+₹1,49950,000 MCP calls (2,500 a day)₹0.0300₹29.98REST for personal, non-commercial use only. Business use needs Enterprise (custom price).
Tapetide Pro₹99920,000 MCP calls (1,200 a day)₹0.0500₹49.95MCP only. Business use needs Enterprise.
IndianAPI Growth₹1,79950,000 requests₹0.0360₹35.98REST, 1 request a second. Commercial terms could not be checked (terms page returned 404).
IndianAPI Pro₹3,999100,000 requests₹0.0400₹39.99REST, 10 requests a second.
Drishti Starter₹2,00010,000 credits₹0.200₹200REST, WebSocket, MCP. Credits are charged per item returned: 1 or 2 per announcement, so one list call can use many.
Drishti Pro₹10,00050,000 credits₹0.200₹200Credits are charged per item returned.
EODHD Equity Analyst$59.99 (about ₹5,631)100,000 calls a day; a fundamentals request costs 10₹0.0188₹18.77Per-call figure is per fundamentals request at full daily use. An end-of-day price call costs 1, a tenth of that. Personal plan; internal company use is a separate $399 plan.
EODHD Internal Use (commercial)$399 (about ₹37,450)100,000 calls a day; a fundamentals request costs 10₹0.125₹125Per fundamentals request at full daily use. Data may only be used inside your company.
Zerodha Kite Connect₹500No quota; rate limits onlyNo per-call priceNo per-call pricePrices and candles only, no fundamentals or filings. Needs a Zerodha account.
DhanHQ Data API₹499 plus taxes100,000 a day; rate limitsNo per-call priceNo per-call priceMarket data only, no fundamentals or filings. Needs a Dhan account.
Screener.in Premium₹4,999 a yearNo APINo per-call priceNo per-call pricePersonal, non-commercial use. Exports from the website only.
TrueData Market Data APIQuote on requestNot publishedNo per-call priceNo per-call priceReal-time vendor. Internal use; public display needs exchange approval.

DalalOS prices are read from our live plan catalog and include taxes; see pricing. Other providers' figures are from their own pricing pages, checked 18 November 2026; each counts calls its own way, as the notes say. Prices change, so check the vendor before you buy.

What common calls cost on Business+

Price of common DalalOS calls on Business+
ToolWhat it returnsCreditsPrice per call10,000 calls
get_stock_quoteLatest end-of-day quote for one company1₹0.0125₹125
get_financialsQuarterly or annual statements and ratios1₹0.0125₹125
get_shareholdingShareholding pattern by quarter1₹0.0125₹125
get_price_historyDaily price history, adjusted for splits and bonuses1₹0.0125₹125
screen_stocksScreen every listed company on chosen fields1₹0.0125₹125
get_stock_eventsA company's BSE announcements1₹0.0125₹125
get_filing_extractFacts read from one filing (beta)1₹0.0125₹125
get_market_fii_dii_flowDaily FII and DII flows1₹0.0125₹125

FAQ

Common questions

Is this real-time stock data?
No. Prices are end-of-day, taken from the NSE and BSE bhavcopy files after the session closes. There are no live ticks or intraday quotes. Filings and announcements are read through the trading day.
Which companies does the API cover?
Companies listed on NSE and BSE. You can look a company up by NSE symbol, ISIN or BSE code, and the response returns all three where they exist.
Do I need a paid plan?
MCP access works on every plan, including the free one. The REST routes under /v1 need a paid plan that includes REST. The pricing page lists current plans and limits.
Where does the data come from?
From exchange end-of-day files, company filings on BSE, and public sources such as NSDL, MOSPI and FBIL. Each response names its source in the source field, and each dataset page lists the files it uses.
Can I show this data to users of my product?
You can show figures, charts and summaries derived from it. Exchange price data has its own licensing rules, so talk to us before you display raw prices to your users. The licensing page explains what the exchanges charge for.
Does the API give buy or sell recommendations?
No. It returns disclosed data and ratios computed from fixed formulas. It has no verdicts, target prices or recommendations, and nothing it returns is investment advice.

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.

Account holders get product-update emails about every two weeks. Turn them off any time.

KEEP EXPLORING