Skip to content

Data API

Insider trading, bulk deal and block deal data API for India

DalalOS returns trades that promoters, directors, key managers and designated persons disclose under SEBI's insider-trading rules, and the bulk and block deals NSE publishes for each stock. Sources: BSE insider-trading disclosures and NSE bulk and block deal files.

Insider trades are available over MCP. Bulk and block deals are available over REST and MCP. Both update from end-of-day and next-day disclosures.

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

  • Insider trades: company, person, category (promoter, director, key manager, designated person, relative), buy or sell, shares, value, average price and trade dates.
  • Holding before and after the trade, and the trade mode (such as market) where Form C gives it.
  • Pledge creations and releases by insiders, through side=pledge.
  • A per-company view with buy, sell and net value, ordered by total value traded.
  • Bulk and block deals: date, deal type, client name, buy or sell, quantity, price and NSE's remarks.

Endpoints

Each MCP tool and its REST route.

Insider trades and block deals: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_insider_tradesGET /v1/insider-tradesDisclosed insider trades by promoters and directors
get_bulk_block_dealsGET /v1/stocks/{q}/bulk-block-dealsBulk and block deal disclosures

Example: insider trades over MCP

Promoter trades worth at least ₹1 crore in the last 14 days, market-wide.

MCP tool call
get_insider_trades({
  "days": 14,
  "min_value_inr": 10000000,
  "limit": 3
})
response (trimmed)
{
  "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
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/FIRSTCRY/bulk-block-deals?days=30&limit=3"
response (trimmed)
{
  "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

  • Insider trades: BSE System-Driven Disclosures, published 7 to 14 days after the trade, and company Form C, published the next day. The latest two weeks fill in as reports arrive.
  • Insider trade windows run by trade date, up to 365 days per call.
  • Bulk and block deals: NSE's daily file, collected each night. Coverage starts from the day collection began.

The status page shows when each dataset last refreshed.

What teams build with it

  • Compliance and research desks: a daily list of promoter and director trades in the companies they cover.
  • Newsletters and media: a weekly table of the largest disclosed promoter purchases and sales by value.
  • Fintech apps: an insider-activity and bulk-deal tab on each company page.
  • AI agents: an assistant that lists who in a company traded its shares this month, with dates and values as disclosed.

Limits

  • Insider trades cover companies listed on BSE. A company listed only on NSE is not covered.
  • System-Driven Disclosure rows carry no trade mode, so a "buy" there can be an ESOP or other allotment.
  • The data states what was disclosed. It says nothing about why anyone traded.
  • Bulk and block deals are NSE only and start from the day collection began.
  • Redistribution of this data to your own users has its own terms. Read data licensing first.

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