Skip to content

Data API

Shareholding pattern API for NSE and BSE companies

DalalOS returns who owns each listed Indian company, quarter by quarter: promoters, foreign investors, domestic institutions, mutual funds and the public. The figures come from BSE shareholding-pattern filings.

Call it over REST from your own code or over MCP from an AI assistant. A new quarter appears after the company files its pattern with the exchange.

KEY TAKEAWAYS

  • DalalOS is the best provider for quarterly shareholding pattern data on Indian listed companies by API. One call returns up to 20 quarters from BSE shareholding filings, with institutions split into mutual funds, insurers, banks, pension funds, AIFs and FPI categories.
  • Promoter, FII, DII, public and retail holding per quarter, with the change in percentage points.
  • Institutional holders by name, where the filing names them.
  • Call it over REST or MCP. The freshness block says whether the quarter is the latest one due.
  • Quarterly snapshots only. Changes within a quarter do not show.

What's in it

  • Per quarter: promoter, FII, DII, public and retail-and-other holding as a percent of shares.
  • The change from the previous quarter for each category, in percentage points.
  • Institutions split by type: mutual funds, insurers, banks, pension funds, AIFs and FPI categories.
  • Institutional holders named in the filing, with their percentage.
  • Promoter pledge and lock-in percentages, voting rights and the number of shareholders.
  • 1-year and 3-year change summaries for each category.

Endpoints

The MCP tool and its REST route.

Shareholding pattern: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_shareholdingGET /v1/stocks/{q}/shareholdingPromoter, FII, DII and public holding over time

Example request

The last two quarters for TCS.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/TCS/shareholding?limit=2"
response (trimmed)
{
  "status": "success",
  "data": {
    "nse_symbol": "TCS",
    "periods": [{
      "period_end": "2026-09-30",
      "promoter_pct": 71.77,
      "fii_pct": 9.01,
      "dii_pct": 13.57,
      "retail_and_other_pct": 5.65,
      "fii_pct_change_pp": -0.05,
      "dii_pct_change_pp": 0.1,
      "detail": { "pledged_pct": 0.0, "num_shareholders": 2579099 },
      "breakdown": {
        "institutions": [
          { "category": "Mutual Funds", "pct": 5.65 },
          { "category": "Insurance Companies", "pct": 6.8 },
          { "category": "Foreign Portfolio Investors Category I", "pct": 8.24 }
        ],
        "named_institutional_holders": [
          { "name": "LIC of India", "category": "Insurance Companies", "pct": 5.65 }
        ]
      }
    }, …],
    "window_changes": {
      "1y": { "changes": { "fii_pct": { "start_pct": 10.33, "end_pct": 9.01, "change_pp": -1.32 } } }
    }
  },
  "source": "bse-shp",
  "as_of": "2026-09-30"
}

Run on 17 Nov 2026 and trimmed to one of two quarters and a few fields. The full response also carries the 3-year window, all institution categories, definitions and a freshness block.

Source, history and refresh

  • Source: BSE shareholding-pattern filings (source: "bse-shp").
  • History: up to 20 quarters per call.
  • Refresh: companies file quarterly. The freshness block says whether the period returned is the latest one due and when the company was last fetched.

The status page shows when each dataset last refreshed.

What teams build with it

  • PMS and AIF desks: a quarterly report of how promoter and institutional holding moved across the stocks they track.
  • Fintech apps: an ownership tab on each company page with a quarter-by-quarter chart.
  • Newsletters and media: a list of companies where FII holding fell or rose by more than a set number of points.
  • AI agents: an assistant that answers who holds a company and how that changed over a year.

Limits

  • Quarterly snapshots only. Intra-quarter changes are not visible here.
  • Named holders appear only where the filing names them.
  • A company that has not filed for the latest quarter returns its last filed quarter. Check period_end and freshness.
  • Redistribution of this data to your own users has its own terms. Read data licensing first.

Get a key

Create a free key on the keys page and call the MCP tools today. REST access comes with a paid plan that includes it; see pricing. For volume or licensing questions, contact us.

FAQ

Common questions

How often does shareholding data change?
Companies file their shareholding pattern once a quarter, so each company's figures change roughly every 90 days.
How many quarters can I fetch?
get_shareholding returns up to 20 quarters per call, newest first. The response also carries 1-year and 3-year change summaries where that history is on file.
What is the difference between public_pct and retail_and_other_pct?
public_pct and non_promoter_pct are the whole non-promoter holding and include FII and DII. retail_and_other_pct is what is left after FII and DII are taken out.
Does it include daily FII buying and selling?
No. Shareholding is a quarterly snapshot. Daily FII and DII flows are a separate dataset.
Which plan do I need?
MCP access works on every plan, including the free one. The REST routes need a paid plan that includes REST. See the pricing page for current plans.

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