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
freshnessblock says whether the quarter is the latest one due. - Quarterly snapshots only. Changes within a quarter do not show.
What's in it
Endpoints
The MCP tool and its REST route.
| MCP tool | REST route | What it returns |
|---|---|---|
| get_shareholding | GET /v1/stocks/{q}/shareholding | Promoter, FII, DII and public holding over time |
Example request
The last two quarters for TCS.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/TCS/shareholding?limit=2"
{
"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
The status page shows when each dataset last refreshed.
What teams build with it
Limits
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