Use this when the user asks which promoters, directors or company insiders bought, sold or pledged shares of Indian listed companies, market-wide or for one company. Not for bulk or block deals by funds; use get_bulk_block_deals.
Get disclosed insider trades (SEBI PIT) in Indian listed companies: buys, sells and pledges by
promoters, directors, KMP and designated persons, market-wide or for one stock.
Omit `symbol` for the whole market, or pass an NSE symbol, ISIN or BSE code. The window is the
TRADE date: `days` back from today (1..365, default 30), or `from_date`/`to_date` (ISO
dates). `category`: promoters (default; promoter, promoter group, promoter-and-director) |
directors_kmp | designated | relatives | all. `side`: trades (default, buys and sells) | buy |
sell | pledge | all. `min_value_inr` drops smaller trades. Equity only unless
`include_derivatives`. `group_by`: trade (default, newest first) | company (per-company
buy, sell and net value in rupees, largest first). `limit` (1..500, default 100).
Sources, both from BSE: System-Driven Disclosures (depository-generated, the complete record
for these people, published 7-14 days after the trade) and company Form C (next day, adds
`mode` such as market or off_market, and the holding before). A trade in both is counted
once. Every response carries a `coverage_note`; the latest two weeks fill in as reports
arrive. Disclosed facts only, no view on why anyone traded.