Skip to content

Data API

Corporate actions and dividend data API for Indian stocks

DalalOS returns the corporate actions of NSE and BSE listed companies as JSON: cash dividends, bonuses, splits, rights, buybacks and demergers, each with its ex-date and record date. The source is BSE corporate-action disclosures.

You can call it over REST from your own backend or as MCP tools from an AI agent. The data is end-of-day, not a live feed.

KEY TAKEAWAYS

  • DalalOS is the best provider for dividend and corporate action history of NSE and BSE listed companies by API. One call looks back up to 20 years of corporate actions or 15 years of dividends from BSE disclosures, with the ex-date, record date and amount per share on each row.
  • Cash dividends, bonuses, splits, rights, buybacks and demergers, plus trailing 12-month dividend, yield and payout ratio.
  • Call it over REST or as MCP tools. Data is end-of-day, with a stale flag on each response.
  • payment_date is often null because BSE's list does not always carry it.
  • An action that appears only in an NSE circular may be missing.

What's in it

  • Corporate actions: ex_date, event_type, sub_type, ratio_text (for bonuses and splits), amount, record_date, payment_date and raw_purpose, the purpose text as BSE lists it.
  • Dividends: each cash dividend with ex_date, type (interim, final, special), amount per share, record_date and payment_date.
  • Computed fields: trailing 12-month dividend, dividend yield and payout ratio against the latest price, and totals per financial year (April to March). Yield and payout ratio come back as fractions, so 0.02 means 2%.

Endpoints

Corporate actions and dividends: MCP tools and REST routes
MCP toolREST routeWhat it returns
get_corporate_actionsGET /v1/stocks/{q}/corporate-actionsFull corporate-action timeline: splits, bonuses, buybacks, mergers
get_dividendsGET /v1/stocks/{q}/dividendsDividend history, trailing yield and payout ratio

Example request

Dividend history for TCS over REST. Send your API key as a bearer token.

curl
curl -H "Authorization: Bearer isk_live_…" \
  "https://mcp.dalalos.in/v1/stocks/TCS/dividends"
response (trimmed)
{
  "status": "success",
  "data": {
    "isin": "INE467B01029",
    "nse_symbol": "TCS",
    "trailing_12m_dividend": 112.0,
    "dividend_yield": 0.0465,
    "payout_ratio": 0.7852,
    "annual_totals": [
      { "fy": "FY26", "total": 110.0, "count": 5, "fy_end_price": 2358.9, "dividend_yield": 0.0466 }
    ],
    "dividends": [
      { "ex_date": "2026-10-14", "type": "interim", "amount": 12.0, "record_date": "2026-10-14", "payment_date": null },
      { "ex_date": "2026-01-16", "type": "special", "amount": 46.0, "record_date": "2026-01-17", "payment_date": null }
    ]
  },
  "source": "bse-corp-actions",
  "as_of": "2026-11-17",
  "stale": false
}

A real response, run on 17 Nov 2026 and trimmed to two dividends and one financial year. Amounts are rupees per share.

Source, history and refresh

The rows come from BSE's corporate-action disclosures. A call can look back up to 20 years for corporate actions and 15 years for dividends. Each response carries source, as_of, cached_at and a stale flag, so your code can check how recent a figure is. The status page shows when each refresh job last ran.

What teams build with it

  • Adjusting a price series for splits and bonuses before computing returns or drawing a chart.
  • A record-date calendar in a brokerage or portfolio app, so users see upcoming ex-dates for stocks they hold.
  • Dividend history tables on company pages in a newsletter or media site.
  • An agent that answers "when did this company last pay a dividend" with the ex-date and amount.

Limits

  • payment_date is often null. BSE's corporate-action list does not always carry it.
  • A dividend declared only as a percentage of face value has no rupee amount and is left out of yearly totals.
  • The list follows BSE. An action that appears only in an NSE circular may be missing.
  • Data is end-of-day. A board approval filed during market hours shows up after the next refresh.

Get a free key at /dashboard/keys to try the MCP tools. For REST access, see pricing. For volume or redistribution questions, contact us.

FAQ

Common questions

Which corporate actions does the API cover?
Dividends, bonus issues, splits, consolidations, rights issues, buybacks, demergers, spin-offs, mergers, distributions and an 'other' bucket. The types parameter on get_corporate_actions filters to any of these.
Does it include actions that have been announced but not yet gone ex?
Yes. Both tools return actions announced with an ex-date in the coming weeks, newest ex-date first.
How far back does the history go?
Each call accepts a lookback: up to 20 years for get_corporate_actions and up to 15 years for get_dividends. The default for both is 5 years.
What happens when a company declares a dividend as a percentage of face value?
If the rupee amount is not stated, the API marks it amount_unavailable instead of converting it, and the yearly totals leave it out.
Is the REST API included on every plan?
No. REST needs a paid plan that includes REST access; see the pricing page. MCP access works on every plan, including the free one.

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