Tool reference
Dividend history and yield for Indian stocks
get_dividends — Dividend history, trailing yield and payout ratio. This is a read-only research or operational tool. It does not place trades or issue investment recommendations.
What you can ask
Connect DalalOS to Claude or ChatGPT and ask in plain English; the assistant calls get_dividends for you and answers from the figures it returns.
EXAMPLE PROMPTS
- What dividends has Infosys paid over the last 5 years, and what's the trailing yield?
- List ITC's dividends per share for the last five financial years.
- What is the trailing dividend yield and payout ratio for Coal India?
Parameters and response fields
get_dividends
Dividend history, trailing yield and payout ratioUSE WHEN
Every cash dividend a company has paid, plus trailing yield and payout ratio against the latest price.
PARAMETERS
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Company name, symbol, code or ISIN. |
years | integer | No | 5 | Lookback window, clamped. |
RESPONSE DATA
- dividends — ex_date, type, amount, record_date, payment_date.
- annual_totals, trailing_12m_dividend, dividend_yield, payout_ratio.
NOTES
- A dividend declared only as % of face value (not ₹) is marked amount_unavailable rather than guessed.
/stocks/{q}/dividendsSee the same data on DalalOS
Public pages that need no sign-in and show data from the same source.
Related tools
KEEP EXPLORING
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.