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.
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.
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).
Running low?
Two ways to get more calls and credits
Invite a friend, free
When someone signs up through your link, you get 2,000 research credits and they get 500. Bonus credits never expire.
Get your invite linkMove to Pro
5,000 tool calls a day instead of 50, 5,000 research credits instead of 500, and every one of the 94 tools in full.
See ProSee what you have used today at Usage.
Related
Was this page helpful?
Something wrong or missing on this page? Email [email protected]