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_disclosedtells 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
Endpoints
The MCP tool and its REST route.
| MCP tool | REST route | What it returns |
|---|---|---|
| get_pledge_trend | GET /v1/stocks/{q}/pledge-trend | Promoter share-pledge percentage over time |
Example request
Three quarters of promoter pledge for JSW Steel.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/JSWSTEEL/pledge-trend?limit=3"
{
"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
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
- 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