TOOL REFERENCE

get_dividends

Dividend history, trailing yield and payout ratio. This is a read-only tool: it returns raw market data or mechanically-computed ratios, never investment advice.

get_dividends

Dividend history, trailing yield and payout ratio

USE WHEN

Every cash dividend a company has paid, plus trailing yield and payout ratio against the latest price.

PARAMETERS

get_dividends parameters
NameTypeRequiredDefaultDescription
querystringYesCompany name, symbol, code or ISIN.
yearsintegerNo5Lookback 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?

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.