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
staleflag 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
Endpoints
| MCP tool | REST route | What it returns |
|---|---|---|
| get_corporate_actions | GET /v1/stocks/{q}/corporate-actions | Full corporate-action timeline: splits, bonuses, buybacks, mergers |
| get_dividends | GET /v1/stocks/{q}/dividends | Dividend history, trailing yield and payout ratio |
Example request
Dividend history for TCS over REST. Send your API key as a bearer token.
curl -H "Authorization: Bearer isk_live_…" \ "https://mcp.dalalos.in/v1/stocks/TCS/dividends"
{
"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
Limits
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