TOOL API

get_upcoming_dividends

Get historical and upcoming dividend calendar dates for stocks. Calendar records contain only the dividend date and ticker symbol; this endpoint does not return dividend amounts, currency, declaration dates, record dates, or payment dates. Requires at least one of 'symbol' or 'date_eq'. Supports date range filtering and pagination. Use when the user asks about dividend dates or ex-dividend calendars. For dividend amounts, currencies, payout history, or other dividend details for a ticker, use get_historical_dividends. For IPO calendar, use get_upcoming_ipos. For stock splits calendar, use get_upcoming_splits.