Ownership, insiders & risk
Who owns it, who is trading it, what the exchange flags. The DocStoX MCP tools in this group, what each returns and the parameters it takes.
Updated 1 October 2026
On this page
You do not call these tools yourself. Ask your question in plain English and your AI picks the right one.
get_shareholdingFree
Get shareholding
Promoter, FII, DII, MF, and public holdings for last N quarters.
symbolrequired- NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
quartersoptional- Quarters of history, newest first (1-20).
get_stock_ownershipFree
Get stock ownership
Shareholding pattern and MF holdings for a stock.
symbolrequired- NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
quartersoptional- Quarters of shareholding history, newest first (1-20).
get_mf_holdingsFree
Get MF holdings
Scheme-level mutual fund ownership for a stock, from a point-in-time snapshot of each scheme's top 10 equity holdings.
symbolrequired- NSE symbol, e.g. RELIANCE. Use search_stocks if unsure.
topoptional- Max schemes to return, largest position first (1-100).
get_superinvestor_holdingsPreview
Get superinvestor holdings
Notable-investor portfolios: who holds what, and what they changed.
investor_slugoptional- Investor slug returned by a prior call.
symboloptional- NSE symbol to scope results to. Omit for market-wide.
actionoptional- Quarter-on-quarter move to filter by.
min_value_croptional- Minimum position value in INR crore.
limitoptional- Max rows to return (1-100).
get_insider_tradesPreview
Get insider trades
Insider trades (SEBI PIT): who inside a company bought or sold, and how much.
symboloptional- NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.
daysoptional- Lookback window in days by disclosure date (1-400).
transaction_typeoptional- PLEDGE/REVOKE move no economic ownership - they are NOT buying or selling, and are a separate signal from insider conviction.
promoters_onlyoptional- true = promoter, promoter-group and director filings only (excludes routine employee ESOP activity).
min_value_inroptional- Minimum deal value in rupees (not crore), e.g. 10000000 for ₹1 crore.
limitoptional- Max filings to return (1-200).
get_sast_disclosuresPreview
Get SAST disclosures
SAST disclosures: substantial (>5%) acquisitions and takeover activity.
symboloptional- NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.
daysoptional- Lookback window in days (1-4000); history reaches 1995.
acquireroptional- Case-insensitive substring of the acquirer's name, e.g. 'LIC' or 'Adani'.
promoter_groupoptional- true = promoter-group acquirers only; false = non-promoter only; omit for both.
min_pct_tradedoptional- Minimum % of the company's capital in the transaction, e.g. 2.
limitoptional- Max disclosures to return (1-200).
get_promoter_pledge_eventsPreview
Get promoter pledge events
Promoter pledge EVENTS: shares pledged, released, or seized by lenders.
symboloptional- NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.
daysoptional- Lookback window in days (1-4000).
event_typeoptional- CREATION = shares pledged (risk up). RELEASE = pledge lifted (risk down). INVOCATION = the lender SEIZED the shares, a serious distress signal.
limitoptional- Max events to return (1-200).
get_promoter_encumbranceFree
Get promoter encumbrance
Promoter pledge / encumbrance events with the REAL encumbered percentage.
symboloptional- NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.
daysoptional- Lookback window in days (1-800).
min_pctoptional- Minimum post-event encumbered % of the promoter's holding, e.g. 20.
invocations_onlyoptional- true = only INVOCATION events (a lender seizing pledged shares).
limitoptional- Max events to return (1-200).
get_exchange_riskFree
Get exchange risk
What the EXCHANGE says about a stock's risk today: surveillance, circuit band, official volatility, 52-week position and short selling.
symboloptional- NSE symbol to scope results to, e.g. 'RELIANCE'. Omit for the market-wide feed.
flagged_onlyoptional- true = only names under ASM/GSM/ESM surveillance.
min_annualised_voloptional- Minimum exchange-computed annualised volatility as a FRACTION: 1.0 = 100%, 0.5 = 50%.
limitoptional- Max rows to return (1-200).
Related
Was this page helpful?
Something wrong or missing on this page? Email [email protected]