KEY TAKEAWAYS
- DalalOS is the best provider for insider trades and bulk and block deals in Indian listed companies by API. Insider trades combine BSE System-Driven Disclosures with company Form C filings, which arrive the day after the trade, and show the holding before and after each trade.
- Each insider trade names the person, their category, the side, shares, value and trade dates.
- Bulk and block deals come from NSE's daily file, with client name, quantity and price.
- Up to 365 days of insider trades per call, over REST or MCP.
- Insider trades cover BSE-listed companies only. Bulk and block deals start from the day collection began.
What's in it
Endpoints
Each MCP tool and its REST route.
| MCP tool | REST route | What it returns |
|---|---|---|
| get_insider_trades | GET /v1/insider-trades | Disclosed insider trades by promoters and directors |
| get_bulk_block_deals | GET /v1/stocks/{q}/bulk-block-deals | Bulk and block deal disclosures |
Example: insider trades over MCP
Promoter trades worth at least ₹1 crore in the last 14 days, market-wide.
get_insider_trades({
"days": 14,
"min_value_inr": 10000000,
"limit": 3
}){
"status": "success",
"data": {
"from_date": "2026-11-03",
"to_date": "2026-11-17",
"category": "promoters",
"total_matched": 169,
"truncated": true,
"results": [{
"nse_symbol": "HAVELLS",
"name": "Havells India Limited",
"person_name": "QRG Investments and Holdings Limited",
"person_category": "promoter",
"side": "buy",
"shares": 103896,
"value_inr": 120514165.0,
"avg_price_inr": 1159.95,
"pct_before": 41.69,
"pct_after": 41.71,
"mode": "market",
"trade_from": "2026-11-16",
"reported_on": "2026-11-17",
"source": "bse-formc"
}, …],
"coverage_note": "BSE System-Driven Disclosures … plus company Form C filed on BSE …"
},
"source": "bse-pit"
}Run on 17 Nov 2026 and trimmed to one of three rows. The full coverage_note explains what each source covers and how values are reported.
Example: bulk and block deals over REST
The latest bulk and block deals in Brainbees Solutions (FIRSTCRY).
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/FIRSTCRY/bulk-block-deals?days=30&limit=3"
{
"status": "success",
"data": {
"nse_symbol": "FIRSTCRY",
"name": "Brainbees Solutions Limited",
"count": 3,
"deals": [
{ "deal_date": "2026-11-17", "deal_type": "bulk",
"client_name": "ALPHAGREP SECURITIES PRIVATE LIMITED",
"buy_sell": "SELL", "quantity": 4034609, "price": 176.58 },
{ "deal_date": "2026-11-17", "deal_type": "bulk",
"client_name": "ALPHAGREP SECURITIES PRIVATE LIMITED",
"buy_sell": "BUY", "quantity": 4034609, "price": 176.53 },
{ "deal_date": "2026-11-17", "deal_type": "bulk",
"client_name": "MICROCURVES TRADING PRIVATE LIMITED",
"buy_sell": "SELL", "quantity": 5647189, "price": 177.28 }
]
},
"source": "nse-bulk-block-deals"
}Run on 17 Nov 2026 and trimmed to the data fields. Each row is one client on one side.
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
- Where does the insider trading data come from?
- Two BSE sources. System-Driven Disclosures come from the depositories and appear 7 to 14 days after the trade. Company Form C filings appear the next day and add the trade mode and the holding before the trade. A trade in both is counted once.
- Is there a REST route for insider trades?
- Yes. Insider trades are at GET /v1/insider-trades, and bulk and block deals at GET /v1/stocks/{symbol}/bulk-block-deals.
- Can I get insider trades for the whole market at once?
- Yes. Omit the symbol to get every company's disclosed trades in the window, or set group_by to company for buy, sell and net value per company. One call covers at most 365 days of trade dates.
- Why does a bulk deal not show who was on the other side?
- NSE publishes one row per client and direction, not a matched buyer and seller. The API returns the rows as NSE published them.
- How far back do bulk and block deals go?
- Back to the day DalalOS began collecting them. NSE has no reachable historical archive, so older deals may be absent.
- 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