TOOL REFERENCE
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.
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.
EXAMPLE PROMPTS
- What dividends has Infosys paid over the last 5 years, and what's the trailing yield?
/stocks/{q}/dividendsKEEP 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.