get_dividend_profile
Dividend profile for a ticker
One U.S.-listed stock, ETF or fund's dividend record: forward yield, annual dividend, payout frequency, payout ratio, years of consecutive increases, A-F dividend safety grade, next ex-dividend and pay dates, fair value estimate and its dividend raises and cuts, newest first. Use for questions like "does Coca-Cola pay a dividend", "when is O's next ex-dividend date" or "has PepsiCo ever cut its dividend".
Parameterstickerrequiredhistory_limit
search_securities
Find a ticker
Search U.S.-listed stocks, ETFs and funds by company or fund name or ticker. Dividend payers and larger companies come first. Use it to turn a name like "Realty Income" or "JPMorgan Nasdaq premium income" into a ticker for get_dividend_profile.
Parameterslimitqueryrequired
get_ex_dividend_calendar
Ex-dividend calendar for a date
Every U.S.-listed dividend going ex on one date, with the amount, pay date, yield, safety grade and change from the previous payment, plus the last day to buy the shares and still get the dividend. Defaults to today; dates up to 120 days ahead include announced dividends.
Parametersdatelimit
get_dividend_changes
Dividend raises and cuts
Every dividend increase, cut, suspension, special dividend and new dividend among U.S.-listed companies going ex in one week, with the old and new amount, percent change, growth streak and the safety score the company held beforehand. Defaults to the last 7 days.
Parameterskindweek
get_option_income_etfs
Option-income (covered call) ETF distributions
Distributions of option-income and covered-call ETFs such as YieldMax (MSTY, TSLY), Roundhill WeeklyPay, JPMorgan JEPI and JEPQ, NEOS, Global X and Defiance: the latest payout and its change from the previous one, the next declared payout, payment frequency, annualized distribution rate, trailing 12-month yield and one-year total return.
Parameterssortlimitfamilysymbol
get_dividend_raise_calendar
When companies usually raise their dividend
Companies that declare their first dividend increase of the year in the same calendar month most years, from the last five complete years: how many years matched, the last and typical raise, and whether this year's raise has been declared yet. Ask by month (1-12) or by ticker.
Parameterslimitmonthsymbol
get_dividend_payers_by_month
Stocks that pay dividends in a month
U.S.-listed stocks that paid a dividend in a given calendar month over the last year, split into quarterly payers (including off-cycle schedules), semiannual and annual payers, and monthly payers. Useful for building a portfolio that pays every month. Largest companies first.
Parameterslimitmonthrequiredschedule