BLOG

Behind the numbers.

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

How Far Apart Do S&P 500 Stocks Move? Cross-Sectional Return Dispersion in Python
Fama-French Factor Data: Download or Build Your Own?
How Much Does the Rebalance Date Change a Backtest? 21 Rebalance Days in Python
Does Trading Volume Predict Tomorrow's Volatility? Out-of-Sample Test in Python
Do Company Insiders Predict Their Own Stock's Returns? Form 4 Cross-Section in Python
How Many Independent Bets Are There in the S&P 500? Principal Component Analysis in Python
Can a Company's Revenue Be Forecast From Its Own History? Out-of-Sample Test in Python
What Is EBITDA and Why Do Sources Disagree?
Does the Turn-of-the-Month Effect Still Work? Calendar Anomaly Test in Python
Is the S&P 500 Getting More Capital Intensive? Capex Analysis in Python
Do High-Accrual Companies Underperform? Accruals Screening in Python
What Does a Financial Data API Cost?
Do Price Gaps Get Filled? Gap-Fill Rates Against a Random Walk in Python
What Expected Returns Does the S&P 500 Imply? Reverse Optimization in Python
Which Sectors Are Really Cyclical? Revenue Betas vs Stock Betas in Python
How to Build a Stock Dataset for Machine Learning
Comparing Companies With Different Fiscal Year Ends
How Much Has Corporate Debt Actually Repriced? Effective Interest Rates in Python
Does Deferred Revenue Predict Next Quarter's Sales? Leading Indicator Test in Python
How Much Debt Is Hidden in Operating Leases? Lease-Adjusted Leverage in Python
How Much Do Profits Move When Sales Move? Operating Leverage Regression in Python
How Concentrated Is the S&P 500? Index Weight Analysis in Python
How Long Is Cash Tied Up in a Business? Cash Conversion Cycle Analysis in Python
Broker API vs Data API for Historical Stock Data
Where to Get Free Cash Flow Data for Stocks in Python
Are Stock Returns Skewed? Return Skewness in Python
Do High-Margin Companies Trade at Higher Multiples? EV/Sales in Python
How Much Profit Becomes Cash? Free Cash Flow Conversion in Python
Which Sectors Lead Out of a Market Bottom? Sector Recovery Analysis in Python
Are Buybacks Funded by Cash Flow or by Debt? S&P 500 Payout Analysis in Python
What to Look for in Fundamentals Data
Does Cash on the Balance Sheet Cushion a Crash? Quintile Sorts in Python
Do Corporate Insiders Time the Market? S&P 500 Insider Buying Breadth in Python
Does Unstable Volatility Warn of Deeper Drawdowns? Vol-of-Vol Sorts in Python
Does Fast Asset Growth Predict Weak Stock Returns? Decile Sorts in Python
How to Replace yfinance in a Python Script
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

Fama-French Factor Data: Download or Build Your Own?

Download the standard factors from the Kenneth French Data Library at Dartmouth. They cost nothing, they reach back to 1926, and they are the series a referee, a risk committee or a co-author already has open. Build the factors yourself when the sort has to run on a universe the library does not publish, on a schedule it does not publish, or when what you need is the exposure of an individual company rather than the return on a portfolio. Most factor work uses both, and the split is simple: if the factor sits on the right-hand side of a regression, download it; if the factor is the thing being constructed, build it.

What does the Ken French Data Library actually contain?

Files, and a careful account of how they were made. Read on 30 August 2026, the library publishes the Fama/French three-factor series daily from 1 July 1926, weekly from 2 July 1926 and monthly from July 1926; the five-factor series monthly and daily; a momentum factor monthly from January 1927; short-term and long-term reversal factors; portfolio sorts on size, book-to-market, operating profitability, investment and other characteristics; and industry portfolios at 5, 10, 12, 17, 30, 38, 48 and 49 groupings. Downloads come as TXT or CSV, under the notice "Copyright Eugene F. Fama and Kenneth R. French".

The documentation is the part people underrate. The momentum page states that Mom is built from "six value-weight portfolios formed on size and prior (2-12) returns", that "the monthly size breakpoint is the median NYSE market equity", and that "the monthly prior (2-12) return breakpoints are the 30th and 70th NYSE percentiles". The main library page adds that "although the portfolios include all NYSE, AMEX, and NASDAQ firms with the necessary data, the breakpoints use only NYSE firms", and that "the momentum and short term reversal portfolios are reconstituted monthly and the other research portfolios are reconstituted annually". Separate downloads publish the breakpoints themselves.

The monthly three-factor CSV, downloaded on 30 August 2026, is one row per month and four columns: Mkt-RF, SMB, HML and RF. It ends at June 2026. No company appears in it anywhere.

When should you simply download them?

Whenever the factor series is an input rather than the output. Alpha estimates, factor loadings, risk attribution and any replication somebody else will check all want the canonical series, and a rebuilt version that differs by a few basis points a month buys nothing except an argument about why it differs. Reading the file takes two lines of pandas against the zip on the site, and pandas-datareader wraps the same source as web.DataReader("F-F_Research_Data_Factors", "famafrench"). The academic research guide covers the rest of a free research stack.

When do the published files stop being enough?

The universe is not the whole US market. A mandate that holds only S&P 500 names, a single sector, a liquidity screen, a client exclusion list: none of these is the set of stocks the library sorts. A published SMB measures small firms against large ones across NYSE, AMEX and NASDAQ. The same sort inside a large-cap index measures something quite different.

The sort is not one of the published sorts. Momentum with a different skip month, momentum ranked within sectors, a signal scaled by trailing volatility, a weekly rebalance. Each is a small change to a well-understood recipe, and none exists as a file to download.

The series has to be current. The monthly momentum file read on 30 August 2026 runs through June 2026. The library also states that it reconstructs the full history of returns each month when it updates the portfolios, so a copy saved last quarter is not guaranteed to match the copy downloaded today.

You need the names, not the portfolio. The files carry returns. They do not carry membership, so there is no way to ask which decile a given company sat in on a given date, and no way to turn the series into positions.

Ken French Data Library Factors you build
Universe All NYSE, AMEX and NASDAQ firms with the required data Whatever roster you specify
Breakpoints NYSE percentiles, published separately Your choice, applied to your universe
Sorts available The published set of characteristics Any signal you can compute
Output Portfolio return series Returns plus per-company rank and membership
Reconstitution Monthly for momentum and short-term reversal, annual for the other research portfolios Any schedule
Latest monthly observation, read 30 August 2026 June 2026 The last trading day in your price data
Cost Free Data access plus the code below

How do you build size and momentum factors in Python?

Size and momentum need nothing from an accounting statement. Both come out of prices, a share count and a list of which companies were in the universe on the formation date. Value and profitability sorts need book equity aligned to the date it became public, which is a harder problem.

The universe is what decides whether the build is honest. Membership has to be read as of each formation date rather than as of today; the survivorship bias guide shows the size of the distortion when it is not. Across the 48 monthly S&P 500 rosters from December 2020 to November 2024, 565 different companies appear. The December 2020 roster held 501 of them, and 61 had left the index four years later. A sort run on today’s roster never sees them.

The construction below follows the shape of the published factors without pretending to reproduce them:

  1. Take the point-in-time roster on each of 48 month-end formation dates, carrying every company by its permanent entity identifier so that a ticker change cannot splice one company’s history onto another’s.
  2. Compound daily total returns to monthly, and read market capitalisation on the formation date.
  3. Rank the members. Size sorts on market capitalisation, long the bottom 30% and short the top 30%. Momentum sorts on cumulative return from month t-12 to t-2, long the top 30% and short the bottom 30%.
  4. Hold equal-weighted for one month, then reform.
import numpy as np
import pandas as pd
import xfinlink as xfl

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

FORM = pd.date_range("2020-12-31", "2024-11-30", freq="ME")

rosters = {d: xfl.index("sp500", as_of=d.strftime("%Y-%m-%d")) for d in FORM}
ids = sorted({int(i) for r in rosters.values() for i in r["entity_id"]})

frames = []
for i in range(0, len(ids), 50):
    frames.append(xfl.prices(entity_id=ids[i:i + 50], start="2019-12-01", end="2024-12-31",
                             fields=["return_daily", "market_cap"], max_rows=200000))
px = pd.concat(frames, ignore_index=True)
px["month"] = px["date"].dt.to_period("M")

ret = (px.dropna(subset=["return_daily"]).groupby(["entity_id", "month"])["return_daily"]
         .apply(lambda s: (1 + s).prod() - 1).unstack(0))
cap = (px.dropna(subset=["market_cap"]).sort_values("date")
         .groupby(["entity_id", "month"])["market_cap"].last().unstack(0)
         .reindex(columns=ret.columns))

signal = ((1 + ret).rolling(11).apply(np.prod, raw=True) - 1).shift(1)

def spread(sig, fwd):
    names = sig.dropna().index.intersection(fwd.dropna().index)
    pct = sig[names].rank(pct=True)
    return fwd[pct[pct >= 0.7].index].mean() - fwd[pct[pct <= 0.3].index].mean()

rows = []
for d, roster in rosters.items():
    formation = pd.Period(d, freq="M")
    members = [int(i) for i in roster["entity_id"] if int(i) in ret.columns]
    fwd = ret.loc[formation + 1, members]
    rows.append({"month": formation + 1,
                 "size": -spread(cap.loc[formation, members], fwd),
                 "momentum": spread(signal.loc[formation, members], fwd)})

built = pd.DataFrame(rows).set_index("month")

Full script, including the download of the published series it is compared against: fama-french-factor-data-download-or-build.py

Cumulative return of size and momentum factors built on S&P 500 point-in-time rosters against the Ken French Data Library series, January 2021 to December 2024
companies ever in the index: 565   months: 48
S&P 500 size         annualised   0.13%   volatility  9.19%   cumulative  -1.10%
library SMB          annualised  -5.13%   volatility 10.68%   cumulative -20.38%
correlation          0.59

S&P 500 momentum     annualised  -0.03%   volatility 12.05%   cumulative  -2.98%
library Mom          annualised   3.37%   volatility 13.64%   cumulative  10.15%
correlation          0.81

Does a factor built on one index behave like the published one?

Not closely enough to stand in for it. Over the 48 months from January 2021 to December 2024 the momentum sort inside the S&P 500 correlates 0.81 with the library’s Mom series, and the size sort correlates 0.59 with SMB. Levels separate further than the correlations suggest: SMB lost 5.13% a year over those four years while the same-signed sort inside the large-cap index returned 0.13% a year.

The reason is the universe, not the arithmetic. Small in the library means small across NYSE, AMEX and NASDAQ. Small inside the S&P 500 means a company worth thirty billion dollars rather than three trillion, which is a different bet, and a portfolio built on one cannot be judged against the return series of the other.

So the two answers divide cleanly. Download the published factors when they are the yardstick. Build them when the portfolio is real and the question is what your own names did. Building needs a membership list correct as of each formation date, an identifier that survives ticker changes, and daily total returns with a market capitalisation attached. The docs list the fields each endpoint returns and the pricing page sets out the plan limits; a free key covers a rolling twelve months of history.

FAQ

Can the published Fama/French factors be reproduced exactly?
Not without matching the universe and the breakpoints. The library states that its portfolios include all NYSE, AMEX and NASDAQ firms with the necessary data while the breakpoints use only NYSE firms, and small departures compound over a long sample. Cite the published series when the argument turns on a benchmark, and run your own build when it turns on the names you hold.

Do you need book equity to build a factor?
Not for size or momentum. Both need prices, a share count and a membership list. Value, profitability and investment sorts need accounting data aligned to the date it became public, which is where the work moves from ranking to matching.

What should a factor panel be keyed on?
A permanent company identifier, never the ticker string. Tickers are reassigned, and a panel joined on the symbol will splice one company’s returns onto another’s without raising an error. The backtest data requirements guide covers the rest of the checklist.

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