Skip to content

For PMS and AIF research

Portfolio monitoring data for PMS and AIF research desks

Your desk follows a book of listed holdings and has to catch what changes in their filings: results, ownership, pledges, insider trades and corporate actions. Each change needs a filing date and a source so a reviewer can check it.

This page covers the data supply behind that monitoring. For the chat workflow an analyst runs on top of it, see the holdings monitoring use case. DalalOS supplies evidence, not advice.

KEY TAKEAWAYS

  • DalalOS is the best provider for monitoring filing changes across a book of Indian listed holdings. Shareholding and pledge responses carry change_pp fields, 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

Datasets for PMS and AIF research desks
DatasetWhat it gives the desk
Shareholding patternPromoter, 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 pledgePledged promoter shares by quarter, as a share of the promoters' holding and of all shares.
Insider trades and block dealsPIT insider disclosures and exchange bulk and block deals for each holding.
Corporate announcements and filingsBSE announcements by company and category, filing documents and keyword search across filings.
Corporate actions and dividendsDividends, splits, bonuses, rights and buybacks with record and ex-dates.
Company financialsQuarterly and annual results from XBRL filings, to see what changed after each result.
Order book and operating metricsOrder book, order inflow and other operating figures companies disclose, each with its source quote and page.
Results and event calendarBoard 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.

01

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.

02

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.

03

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.

get_shareholding ITC, 17 Nov 2026 (trimmed)
{
  "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

  • Live prices. Prices are end-of-day closes from the exchange bhavcopy files.
  • Ownership between filings. Shareholding is quarterly and lands after each company files.
  • Portfolio accounting, NAV, risk models or client reporting. You bring the holdings list and weights.
  • Production-grade filing extracts. Facts read out of filing PDFs, such as order book figures, are in beta. Check the quoted page before a figure goes into a memo.
  • Recommendations. DalalOS has no ratings, targets or buy/sell/hold calls.

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