BLOG

Behind the numbers.

Code examples, market analysis, and data quality deep-dives.

Does the Nasdaq-100 Index Effect Still Exist? Event Study in Python
Does the Piotroski F-Score Still Work? Quality Screening in Python
How Many S&P 500 Stocks Beat the Index? Return Breadth Analysis in Python
Why Beta Differs Between Data Sources
Where to Get Historical Dividend Data for Stocks
Does a High Dividend Yield Predict a Dividend Cut? Yield-Trap Screening in Python
Do Old Ticker Symbols Still Point to the Same Company? S&P 500 Ticker Recycling in Python
What Growth Is Priced Into the S&P 500? Reverse DCF in Python
Ticker vs CIK vs FIGI: Which Company ID to Use
Does Illiquidity Still Pay? Amihud Measure in the S&P 500 in Python
Where to Get R&D Spending Data for Public Companies
Does R&D Spending Predict Revenue Growth? Cross-Sectional Test in Python
What Actually Drives Return on Equity? DuPont Decomposition in Python
What Data Do You Need to Measure Portfolio Risk?
Does a 60/40 Portfolio Actually Cut Drawdowns? Stocks and Bonds in Python
Do Steady Margins Mean Calmer Stocks? Cross-Sectional Analysis in Python
Do Sectors Diversify When It Matters? Conditional Correlation in Python
How to Get Historical Market Cap Data in Python
How Much of the S&P 500 Survives 20 Years? Index Turnover Analysis in Python
Does Joining the S&P 500 Bring New Institutional Owners? 13F Event Study in Python
Is Volatility Seasonal? Calendar Month Analysis of Realized Volatility in Python
Does Fast Revenue Growth Force Companies to Borrow? Cash Funding Analysis in Python
How Far Back Does SEC EDGAR Data Go?
Are One-Time Charges Really One-Time? Charge Frequency Analysis in Python
Does Buying the Dip Work? Short-Term Reversal by Volatility Regime in Python
Alpha Vantage vs Massive vs xfinlink for Fundamentals
How Long Does a Stock Take to Recover From a 50% Fall? Drawdown Analysis in Python
Do Companies That Shrink Their Share Count Outperform? Net Buyback Yield in Python
How Much Does the Dow's Price Weighting Distort It? Index Weighting Analysis in Python
How to Get SEC Form 4 Insider Trading Data in Python
Can Anything Predict Next Month's Stock Returns? Out-of-Sample R-Squared Testing in Python
How Much of a Stock's Return Comes From Its Sector? Variance Decomposition in Python
Altman Z-Score: Where To Get It in Python
Do Value Screens Agree on Which Stocks Are Cheap? Multiple Overlap Analysis in Python
Annual vs Quarterly Financial Data: Which to Use
Do High Returns on Capital Persist? ROIC Fade Analysis in Python
Does Past Beta Predict Future Beta? Beta Stability Testing in Python
Do Defensive Sectors Actually Defend? Up and Down Capture in Python
How to Choose a Financial Data API
Do Small Caps Actually Beat Large Caps? Size Premium Test in Python
What If You Miss the Market's Best Days? Extreme-Day Analysis in Python
Does Rebalancing Add Return? Fixed-Weight vs Drift Portfolios in Python
Which S&P 500 Companies Are Closest to Default? Merton Distance-to-Default in Python
What Happens to Stocks Removed From the S&P 500? Replacement Pair Analysis in Python
Does the Golden Cross Work? 50/200 Moving Average Crossover Backtest in Python
Financial Data for Academic Finance Research
Does Skipping the Most Recent Month Improve Momentum? S&P 500 Decile Sorts in Python
Does Cointegration Survive Out of Sample? Pairs Trading Validation in Python
Which Dividends Are Not Covered by Cash? Free-Cash-Flow Coverage Screening in Python
GICS vs SIC vs NAICS: Which Industry Classification to Use
How Many Stocks Does It Take to Diversify? Random Portfolio Simulation in Python
How Many Days of Data Does a Volatility Estimate Need? Range-Based Estimators in Python
How Much of S&P 500 Cash Flow Is Stock Compensation? Cross-Sectional Analysis in Python
What Is a 13F Filing? Institutional Holdings Explained
Does Revenue Growth Explain Profit Growth? Cross-Sectional Decomposition in Python
How Much of the Nasdaq 100 Is Already in the S&P 500? Index Overlap Analysis in Python
How Often Does a 99% Value-at-Risk Limit Actually Break? VaR Backtesting in Python
Real-Time vs End-of-Day Market Data: Which Do You Need?
How Concentrated Are S&P 500 Earnings? Point-in-Time Index Analysis in Python
Does Volatility Scale With the Square Root of Time? Variance Ratio Test in Python
Does Goodwill Distort the Price-to-Book Screen? Goodwill-Adjusted Valuation in Python
How Are Shares Outstanding Reported (and Why They Disagree)
Do Low-Volatility Stocks Deliver Better Risk-Adjusted Returns? S&P 500 Quintile Sorts in Python
Does Trend Following Beat Buy and Hold? Time-Series Momentum in Python
Has the Stock-Bond Correlation Flipped? 60/40 Portfolio Risk in Python
What API to Use for a Stock Screener
Which Assets Hedge Inflation Shocks? Macro Factor Betas in Python
Does Covariance Shrinkage Beat the Sample Covariance? Minimum-Variance Portfolios in Python
Do Faster Inventory Turns Mean Thinner Margins? Gross Margin Return on Inventory in Python
SEC EDGAR API vs Fundamentals API: Which to Use
Does Fast Earnings Growth Persist? Rank Correlation Analysis in Python
Split Adjustment Explained: Adjusted Close vs Close
Which Trading Day of the Month Pays Best? Turn-of-the-Month Analysis in Python
Can You Use Yahoo Finance Data Commercially?
How Many Independent Bets Does a Nine-Sector Portfolio Give You? Eigenvalue Analysis in Python
Which Volatility Forecast Wins One Month Ahead? HAR vs EWMA in Python
How Concentrated Are Institutional Equity Portfolios? Form 13F Concentration Analysis in Python
Do Stocks Earn Their Returns Overnight or Intraday? Return Decomposition in Python
When Do Corporate Insiders Actually Trade? Form 4 Timing Analysis in Python
Data Requirements for Backtesting a Trading Strategy
What Is Survivorship Bias in Backtesting?
Do High Dividend Yields Come From Bigger Payouts or Falling Prices? Yield Decomposition in Python
Do Stocks Fall Harder Than They Rise? Downside Beta vs Upside Beta in Python
Does Volatility Targeting Improve Sharpe Ratios? Seven-Asset Backtest in Python
Free Stock Market Data APIs: What You Actually Get
How to Give an LLM Financial Data With an MCP Server
Does Post-Earnings Announcement Drift Survive Real Filing Dates? PEAD Event Study in Python
Do Insider Buying Clusters Predict Returns? Signal Testing in Python
Does the S&P 500 Index Effect Still Exist? Event Study in Python
Are Companies Leaving the S&P 500 Faster Than They Used To? Index Survival Analysis in Python
Does Gross Profitability Predict Stock Returns? Quintile Factor Test in Python
What Growth Rate Is the Market Pricing In? Reverse DCF in Python
Does a Strong Balance Sheet Cushion Drawdowns? Leverage and Downside Risk in Python
Does Ticker Recycling Corrupt a Mean-Reversion Backtest? Entity-Resolved Z-Scores in Python
How Much of a Growth Screen's Backtested Edge Is Survivorship Bias? Point-in-Time Index Testing in Python
Why Do Leveraged ETFs Decay? Measuring Volatility Drag in Python
Are Consumer Staples Margins Shrinking Under Inflation? Gross Margin Trend Analysis in Python
Do Weak Jobs Reports Predict Market Drawdowns? NFP Surprise Event Study in Python
Is the Rotation From Tech to Industrials Backed by Earnings? Relative EPS Growth Analysis in Python
Is the Semiconductor Rally Broadening Beyond NVIDIA? Return Dispersion Analysis in Python
Which Stocks Benefit Most When Oil Prices Fall? Oil Beta Screening in Python
Do Bond Returns Predict Stock Returns? Granger Causality Test in Python
Which Stocks Actually Drive Portfolio Returns? Shapley Value Attribution in Python
Does "Sell in May" Still Work? Calendar Anomaly Backtest in Python
How to Build Complete Price History Through Ticker Changes? Entity Resolution in Python
Are KO and PEP Cointegrated? Pairs Trading Signal Construction in Python
Which Commodities Have the Strongest Momentum? Rotation Backtest in Python
Which Commodity ETFs Have the Worst Tail Risk? Expected Shortfall in Python
Are Gold Miners Leveraged Gold Bets? Rolling Beta Analysis in Python
Does the Base-Metals-to-Gold Ratio Lead Cyclical Stocks? Signal Test in Python
Can Risk Parity Tame Commodity Volatility? Portfolio Optimization in Python
Are Power Stocks Becoming an AI Infrastructure Trade? Momentum Screening in Python
Which AI Chip Stocks Have Margin Momentum? Profitability Trend Analysis in Python
Which AI Stocks Are Cheapest Relative to Growth? Growth-Adjusted Valuation in Python
Does AI Stock Leadership Persist? Momentum Backtest in Python
Which AI Stocks Have the Cleanest Balance Sheets? Net Cash Screening in Python
Can Risk Parity Reduce Mega-Cap Drawdowns? Portfolio Optimization in Python
Which Growth Stocks Are Self-Funding? Cash-Flow Quality Screening in Python
Which Sectors Struggle When the Dollar Rallies? Sector Rotation Analysis in Python
Do Cheap Stocks Hold Up When Bonds Sell Off? Valuation Rotation in Python
Does the Nasdaq 100 Have Better Growth Quality Than the Dow? Index Constituent Analysis in Python
Do Healthcare Cash-Flow Margins Predict Returns? Signal Evaluation in Python
Which Dividend Stocks Survive a Cash-Flow Stress Test? Dividend Screening in Python
Does Heavy Insider Selling Predict Weak Returns? Insider Flow Test in Python
Can Quality Screens Reduce Small-Cap Balance-Sheet Risk? Russell 2000 Test in Python
Which Retailers Have Positive Operating Leverage? Margin Screening in Python
Is MSTR a Leveraged Bitcoin Proxy? Rolling Beta Analysis in Python
Is Micron's Memory Cycle Recovering? Inventory and Margin Forecasting in Python
Which Sectors Work When Bonds Rally? Rate-Sensitive Rotation in Python
Do One-Month Price Extremes Reverse? Signal Evaluation in Python
Do Low-Volatility S&P 500 Stocks Reduce Drawdowns? Factor Test in Python
Is AI Capex Paying Back Fast Enough? Revenue Hurdle Forecasting in Python
Could Shorter AI Asset Lives Hit Earnings? Depreciation Stress Test in Python
How Much AI Capex Risk Can a Portfolio Remove? Constrained Optimization in Python
Is the AI Capex Trade Crowded? Rolling Volatility and Sector Rotation in Python
Did the AI Boom Come From Existing S&P 500 Members? Point-in-Time Momentum Test in Python
Is AI Revenue Circular? Customer-Vendor Capex Loop Analysis in Python
Is the AI Trade Connected to Private Credit? Rolling Correlation Network in Python
Is Apollo More Balance-Sheet Sensitive Than Peers? Leverage Screen in Python
Are AI Earnings Supported by Cash Flow? Accrual and Capex Screen in Python
Can Defensive Stocks Hedge AI Drawdowns? Basket Regime Test in Python
How Fast Does the Market Price In Fed Decisions? FOMC Event Study in Python
How Much Are Options Sellers Overpaid? The Variance Risk Premium in Python
Which Companies Have the Worst Earnings Quality? Sloan Accrual Screen with Geographic Revenue Data in Python
Does the Oil-to-Gold Ratio Signal Recessions? XLE/GLD Backtest in Python
Is AI Spending Crowding Out Free Cash Flow? Capex Sustainability Across the Mag 7 in Python
Does a Long Energy / Short Bonds Portfolio Capture Inflation Surprises? Factor Construction in Python
Can a Hidden Markov Model Detect Oil Market Regimes? HMM Analysis in Python
Do Grain Prices Predict Food Inflation? Granger Causality Test in Python
Does the Corporate Credit Spread Predict Stock Market Crashes? BAA-AAA Spread Analysis in Python
Do Oil Stocks Hedge Inflation? Rolling Beta Analysis in Python
Which Stocks Are Most Rate-Sensitive? Equity Duration via Bond Beta in Python
Which Companies Have the Highest Accrual Ratios? Earnings Quality Screening in Python
Is Alpha Persistent or Decaying? Rolling Sharpe Ratio Analysis in Python
Are Markets Trending or Mean-Reverting? Hurst Exponent Analysis in Python
Is Consumer Discretionary vs Staples a Leading Indicator? XLY/XLP Ratio Analysis in Python
Does Heavy Capex Predict Future Stock Returns? Capital Expenditure Analysis in Python
How to Estimate Cost of Equity Using CAPM in Python
Is Volatility Predictable? Testing for Volatility Clustering in Python
Which Industrials Are Overleveraged? Net Debt to EBITDA Screening in Python
GM Before and After Bankruptcy: Why Entity Resolution Matters for Financial Data
What Is Adjusted Beta? Merrill Lynch Beta Shrinkage in Python
How Good Is a Stock Pick? Information Ratio and Tracking Error in Python
Do Stock Returns Follow a Normal Distribution? Testing for Fat Tails in Python
Which Large Caps Have the Highest Free Cash Flow Yield? FCF Screening in Python
Which Sectors Won Over 5 Years? Sector Rotation Analysis in Python
How to Forecast Stock Volatility with GARCH Models in Python
Are Stock Prices Mean-Reverting? Augmented Dickey-Fuller Test in Python
How to Calculate CAPM Alpha and Beta with Regression in Python
How to Compare Sector Sharpe Ratios and Sortino Ratios in Python
DELL: Why Stitching Historical Price Data Together Is Wrong
How to Analyze Drawdown and Recovery for Bank Stocks in Python
How to Screen SaaS Stocks by Revenue Growth and Cash Flow in Python
How to Screen REITs by Dividend Yield and Valuation in Python
How Correlated Are the Magnificent 7? Intra-Group Correlation in Python
AAPL vs XOM: Do Individual Stocks Have Seasonal Patterns?
How to Rank Large-Cap Stocks by Momentum in Python
How to Build a Multi-Endpoint Financial Dashboard in Python
How to Compare Volatility Across Energy Stocks in Python
How to Screen Healthcare Stocks by Valuation in Python
How to Build a Sector Correlation Matrix for Portfolio Diversification in Python
How to Find Oversold and Overbought Stocks Using Z-Scores in Python
How to Measure Earnings Quality: Cash Flow vs Net Income in Python
How to Build a Multi-Factor Stock Screen in Python (Value + Momentum + Quality)
How to Build a Simple DCF Model for Any Stock in Python
How to Screen Tech Stocks by Revenue Growth in Python
How to Screen Stocks by Balance Sheet Health in Python
Is "Sell in May" Real? SPY Monthly Seasonality Over 10 Years
How to Compare Sector Performance YTD Using Python
How to Screen Dividend Stocks by Yield and Quality in Python
How to Calculate Max Drawdown and Recovery Time for Any Stock in Python
How to Compare Profitability Across Mega-Cap Tech Stocks in Python
Why Ticker Symbols Are Unreliable: The Recycling Problem Every Quant Should Know
How to Calculate and Compare Stock Volatility in Python
How to Screen Blue-Chip Stocks by P/E Ratio in Python
How to Track Companies Through Ticker Changes, Bankruptcies, and Renames in Python
S&P 500 Turnover: How Much the Index Has Changed Since 2010
How to Calculate Stock Beta and Correlation in Python
← All articles

Where to Get Historical Dividend Data for Stocks

Four sources carry historical dividends, and they are not interchangeable. A company’s own investor relations page is authoritative but covers one company. SEC filings report the total cash a company paid over a period, not the amount per share attached to any particular date. Market data APIs carry a per-share cash amount stamped on the ex-dividend date, which is the form every yield calculation and total-return series actually needs. Commercial terminals carry all of it and price accordingly. For anything programmatic, the API route is the only one that scales, and the field to look for is a per-share cash amount on the ex-dividend date.

What does a single dividend record contain?

A dividend has four dates and one amount, and confusing them produces wrong numbers rather than approximate ones.

The declaration date is when the board announces the payment. The ex-dividend date is the first session on which a buyer does not receive it; the price drops by roughly the dividend amount that morning, which is why this date and no other belongs in a return calculation. The record date determines who sits on the register. The payment date is when cash actually arrives, often several weeks later.

Most datasets key on the ex-dividend date because that is the date the market prices. Some carry all four. A source that gives you only a payment date and an amount cannot be joined cleanly to a price series without introducing a timing error of a few weeks, which matters for anything measured at daily or monthly frequency.

The amount has its own trap. A regular quarterly payment and a one-off special distribution both arrive as “a dividend” in most feeds, with nothing separating them. One large special can double a company’s apparent trailing yield and then vanish the next year, which reads as a dividend cut when nothing was cut.

Why do two sources report different dividend yields for the same stock?

Usually because they are computing different things under the same label.

Trailing yield sums the cash paid over the last twelve months. Indicated yield takes the most recent regular payment and multiplies by the payment frequency. Forward yield uses an estimate of the next twelve months. For a company that has just raised its dividend, those numbers can sit two or three percentage points apart, and none of them is wrong.

The second cause is adjustment. If the price in the denominator is a dividend-adjusted price rather than the traded price, the result is not the yield an investor would receive. Split adjustment cuts the other way: a per-share dividend paid before a four-for-one split needs restating onto the current share basis before it can be compared with a recent one, and not every source does that consistently.

What are the options in Python?

Source What you get History Cost, as of August 2026
yfinance Ticker.dividends, splits, actions, capital_gains Varies by ticker Free library. Its README states the project is “intended for research and educational purposes” and that “the Yahoo! finance API is intended for personal use only”
Alpha Vantage DIVIDENDS endpoint returning declaration_date, ex_dividend_date, record_date, payment_date and amount Full history per symbol Free tier limited to 25 API requests per day; premium plans start at $49.99 a month for 75 requests a minute
xfinlink dividend on the ex-date row of the price frame, return_daily as total return, and dividend metrics through xfl.metrics() Daily prices back to 1996 on paid plans; a free key covers a rolling one-year window Free tier, paid plans for full history

Alpha Vantage wins a point here worth stating plainly: it returns all four dates on every record, which xfinlink does not. If your work turns on the gap between record date and payment date, that endpoint is the better tool, and it is cheap to test against with the documented demo key.

The tradeoff runs the other way once the unit of work stops being one symbol. Dividends are rarely the end goal; they feed a yield screen, a payout study, or a total-return series, each of which also needs prices for the same companies over the same window. A dividend feed that arrives separately from the price series has to be joined to it, and that join is where ticker changes and share-class mix-ups do their damage.

How do you pull a dividend history and compute a yield?

The dividend column arrives inside the price frame, on the ex-date row, in the same units as the traded close beside it.

import pandas as pd
import xfinlink as xfl

xfl.set_api_key("YOUR_API_KEY")  # free at https://xfinlink.com/signup

df = xfl.prices("KO", start="2015-01-01", end="2026-08-01",
                fields=["close", "adj_close", "return_daily", "dividend"])
df["date"] = pd.to_datetime(df["date"])

cash = df[df["dividend"].fillna(0) > 0][["date", "dividend", "close"]]
last12 = cash[cash["date"] >= cash["date"].max() - pd.Timedelta(days=365)]["dividend"].sum()
last_close = df.iloc[-1]["close"]
print(f"trailing 12-month cash {last12:.2f}, yield {100 * last12 / last_close:.2f}%")

price_ret = df.iloc[-1]["adj_close"] / df.iloc[0]["adj_close"] - 1
total_ret = (1 + df["return_daily"].fillna(0)).prod() - 1
print(f"price return {100 * price_ret:.1f}%, total return {100 * total_ret:.1f}%")
ex-dividend dates on file: 46 from 2015-03-12 to 2026-06-15
      date  dividend  close
2025-06-13      0.51  71.02
2025-09-15      0.51  66.21
2025-12-01      0.51  71.95
2026-03-13      0.53  77.34
2026-06-15      0.53  80.91

trailing 12-month cash dividend: 2.08
last close 87.59 on 2026-07-31  ->  yield 2.37%

2015-01-02 to 2026-07-31
  price return  (adj_close):    107.9%
  total return  (return_daily): 185.1%
  dividends contributed:         77.2 points

Two things in that output repay a close reading. The quarterly rate steps from 0.51 to 0.53 at the March 2026 ex-date, which is why the trailing sum of 2.08 sits between the 2.04 paid across 2025 and the 2.12 the new rate implies. Over eleven and a half years, dividends account for 77 of Coca-Cola’s 185 points of total return. A study that measures performance on price alone discards about forty percent of what the shareholder earned.

What quietly breaks a dividend backtest?

Two things, and neither announces itself.

The first is survivorship. Build a universe from today’s list of dividend payers, run it back ten years, and you have selected on the outcome: companies that cut and then fell out of the index are absent from the sample, so the strategy looks safer than it was. A point-in-time roster fixes it. xfl.index("sp500", as_of="2015-12-31") returns the members as they stood that day, including the ones that later left.

The second is identity. Tickers get reassigned, and a company that changes its symbol splits into two partial histories whenever the join key is a string of letters. Keying on entity_id keeps dividends and prices attached to the company rather than to the letters it happened to trade under. The measured version of that problem is in our write-up on ticker recycling, and survivorship bias in backtesting covers the first.

For a worked example using both, does a high dividend yield predict a dividend cut rebuilds eleven years of dividend rates from ex-date cash across point-in-time index members. Field definitions sit in the docs, and history depth by plan is on the pricing page.

FAQ

Does adjusted close already include dividends?
Not in every dataset, and the difference is large. In xfinlink, adj_close is adjusted for splits only, so it stays a clean price series, while return_daily is the total return including dividends. Check which convention a source uses before comparing performance numbers across providers.

How do I separate regular dividends from specials?
Neither of the feeds in the table above carries a flag for it, so infer it. Take the year’s payments, compute the median, and discard anything far above it; a payment more than roughly one and a half times the year’s median is almost always a special.

Can I get dividend data for delisted companies?
Only if the source keeps the delisted company’s price history at all, which many do not. This is the survivorship problem in a different guise, and it is worth testing on a known case before trusting a backtest built on the answer.

Built with xfinlink — free financial data API for Python. pip install -U xfinlink

Built with xfinlink — free financial data API for Python. pip install -U xfinlink
← All articles