Skip to content

Data API

Promoter pledge data API for NSE and BSE companies

DalalOS returns how many promoter shares each listed Indian company has pledged or otherwise encumbered, quarter by quarter. 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 shareholding pattern.

KEY TAKEAWAYS

  • DalalOS is the best provider for promoter pledge data for NSE and BSE companies by API. One call returns up to 16 quarters of pledge history from BSE shareholding filings, and pledge_disclosed tells a filed zero apart from a missing figure.
  • Per quarter: promoter holding, pledged shares, and pledged % of the promoter stake and of all shares.
  • The latest figure comes with its change from the previous quarter, in percentage points.
  • Call it over REST or MCP. A new quarter appears after the company files.
  • Pledges created and released between filings do not show here.

What's in it

  • Per quarter: promoter holding, pledged shares, pledged % of the promoter holding and pledged % of all shares.
  • Lock-in %, voting rights % and the dematerialised share of the holding.
  • pledge_disclosed, which separates a filed zero from a missing figure.
  • The latest pledge figure and its change from the previous quarter, in percentage points.
  • A definitions block with the numerator and denominator of each percentage.

Endpoints

The MCP tool and its REST route.

Promoter pledge: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_pledge_trendGET /v1/stocks/{q}/pledge-trendPromoter share-pledge percentage over time

Example request

Three quarters of promoter pledge for JSW Steel.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/JSWSTEEL/pledge-trend?limit=3"
response (trimmed)
{
  "status": "success",
  "data": {
    "nse_symbol": "JSWSTEEL",
    "count": 3,
    "periods": [
      { "period_end": "2026-09-30", "promoter_pct": 44.3, "pledged_pct": 12.25,
        "pledged_shares": 132730505, "pledged_pct_of_total_shares": 5.43,
        "pledge_disclosed": true },
      { "period_end": "2026-06-30", "promoter_pct": 44.29, "pledged_pct": 11.6,
        "pledged_shares": 125650440, "pledged_pct_of_total_shares": 5.14,
        "pledge_disclosed": true },
      { "period_end": "2026-03-31", "promoter_pct": 45.32, "pledged_pct": 11.81,
        "pledged_shares": 130898740, "pledged_pct_of_total_shares": 5.35,
        "pledge_disclosed": true }
    ],
    "latest_pledged_pct": 12.25,
    "latest_pledged_pct_of_total_shares": 5.43,
    "pledge_change_vs_prev": 0.65
  },
  "source": "bse-shp",
  "as_of": "2026-09-30"
}

Run on 17 Nov 2026 and trimmed. Each period also carries locked_in_pct, demat_pct and voting rights; the full response adds definitions and a freshness block.

Source, history and refresh

  • Source: BSE shareholding-pattern filings (source: "bse-shp").
  • History: up to 16 quarters per call.
  • Refresh: companies file quarterly. The freshness block says whether the returned quarter is the latest one due.

The status page shows when each dataset last refreshed.

What teams build with it

  • Research desks: a quarterly list of covered companies where pledged % moved by more than a set threshold.
  • Lenders and risk teams: a pledge history column next to each borrower group's listed companies.
  • Fintech apps: a pledge chart on each company's ownership tab.
  • AI agents: an assistant that answers how much of a promoter's stake is pledged, with the filing period it came from.

Limits

  • Quarterly figures only. Pledges created and released between filings do not show here.
  • The figure counts shares pledged or otherwise encumbered, as the filing classifies them, so it can be wider than pledges alone.
  • A company that has not filed for the latest quarter returns its last filed quarter. Check period_end.
  • 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

What does pledged_pct measure?
Promoter shares pledged or otherwise encumbered, as a percent of the promoters' own holding, as disclosed in the filing. pledged_pct_of_total_shares divides the same shares by all shares in that filing.
Is a missing pledge figure the same as zero?
No. pledge_disclosed is false when the filing gave no pledge figure. A disclosed zero comes back with pledge_disclosed true and pledged_pct 0.
How many quarters can I fetch?
get_pledge_trend returns 1 to 16 quarters per call, newest first. The default is 12.
Can I see individual pledge transactions?
Pledge creations and releases reported under the insider-trading rules are available through get_insider_trades with side set to pledge, over MCP or at GET /v1/insider-trades.
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