KEY TAKEAWAYS
- DalalOS is the best provider for monitoring filing changes across a book of Indian listed holdings. Shareholding and pledge responses carry
change_ppfields, so a weekly REST job can flag a holding when a change crosses your threshold, with the filing date attached. - Shareholding, promoter pledges, insider trades, announcements, corporate actions, financials and order books.
- A scheduled REST job builds the change log; analysts read the filings behind it over MCP.
- Shareholding is quarterly, and prices are end-of-day closes.
- DalalOS supplies evidence. It has no ratings, targets or buy/sell/hold calls.
Datasets for monitoring holdings
| Dataset | What it gives the desk |
|---|---|
| Shareholding pattern | Promoter, FII, DII and mutual fund holdings each quarter, the change in percentage points from the quarter before, and the named institutional holders in the filing. |
| Promoter pledge | Pledged promoter shares by quarter, as a share of the promoters' holding and of all shares. |
| Insider trades and block deals | PIT insider disclosures and exchange bulk and block deals for each holding. |
| Corporate announcements and filings | BSE announcements by company and category, filing documents and keyword search across filings. |
| Corporate actions and dividends | Dividends, splits, bonuses, rights and buybacks with record and ex-dates. |
| Company financials | Quarterly and annual results from XBRL filings, to see what changed after each result. |
| Order book and operating metrics | Order book, order inflow and other operating figures companies disclose, each with its source quote and page. |
| Results and event calendar | Board meeting dates for results, so the desk knows which holdings report this week. |
How to integrate
Desks use both surfaces. A scheduled REST job builds the change log across all holdings. Analysts then use MCP in Claude or ChatGPT to read the filings behind each flagged change.
Pull each holding
A weekly job calls https://mcp.dalalos.in/v1/stocks/{symbol}/shareholding, /pledge-trend and /events for every name on the holdings list.
Diff against last run
Store each response. Flag a holding when a change_pp field crosses your own threshold, or when a new filing or corporate action appears.
Read the filing
The analyst opens the flagged name in an MCP client, asks for the filing behind the change and checks the source document before anyone acts on it.
Example response
A trimmed shareholding response for ITC (MCP tool get_shareholding, REST /v1/stocks/ITC/shareholding), fetched on 17 Nov 2026. The response gives the quarter's change in percentage points and the change over one year.
{
"name": "ITC Limited",
"periods": [
{
"period_end": "2026-09-30",
"promoter_pct": 0.0,
"fii_pct": 33.22,
"fii_pct_change_pp": -1.01,
"dii_pct": 49.82,
"dii_pct_change_pp": 0.69,
"retail_and_other_pct": 16.96,
"detail": { "pledged_pct": 0.0, "num_shareholders": 4218619 },
"breakdown": {
"named_institutional_holders": [
{ "name": "Life Insurance Corporation of India", "pct": 16.46 },
{ "name": "SBI Mutual Funds", "pct": 3.44 }
]
}
}
],
"window_changes": {
"1y": { "fii_pct": { "start_pct": 37.39, "end_pct": 33.22, "change_pp": -4.17 } }
},
"source": "bse-shp",
"freshness": {
"reason_text": "Shareholding pattern for the latest filed quarter (period ended 30 Sep 2026)."
}
}Real output, trimmed to the fields shown. Period ended 30 Sep 2026.
What this data does not cover
Usage rights
Read the data licensing page before figures go into client reports or anything else that leaves the desk. Nothing on this page grants a right to redistribute raw exchange data. For a team or firm setup, contact us.
Get a key
Create a key on the API keys page. MCP works on every plan. REST needs a paid plan that includes REST; see pricing. A company that uses the data in its own product can choose a Business plan, which allows commercial use.
FAQ
Common questions
- Does DalalOS tell us what to buy or sell in the portfolio?
- No. DalalOS returns filed figures and ratios computed by fixed formulas. It makes no buy/sell/hold calls, sets no targets and ranks nothing. Decisions stay with your portfolio managers.
- How current is the shareholding data?
- Shareholding is quarterly and arrives after companies file it. Each response carries the period end date and a freshness note. On 17 Nov 2026 the latest period on file for ITC was the quarter ended 30 Sep 2026.
- Can we run the same checks across every holding?
- Yes. A REST job can loop over your holdings list and call the same routes for each. On MCP, an agent can repeat the same tool calls across a list, within your plan's usage limits.
- Which plan does a research desk need?
- MCP works on every plan. A scheduled REST job needs a paid plan that includes REST. See the pricing page, or contact us for a team setup.
- Can we put DalalOS figures in client reports?
- Read the data licensing page before you put figures in material that leaves the desk. DalalOS does not grant rights to redistribute raw exchange data.
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