BLOG

Behind the numbers.

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

Does Revenue Breadth Predict the Stock Market? A Quarterly Diffusion Index in Python
How Much Leverage Maximises Long-Run Growth? Kelly Sizing in Python
How to Run an Event Study in Python
Is a High-Margin Screen Just a Sector Bet? Sector-Neutral Profitability Ranking in Python
Does Proximity to the 52-Week High Beat Momentum? Conditional Quintile Sorts in Python
Does Negative Book Equity Signal Distress? S&P 500 Balance Sheet Screening in Python
How Late Does a Bear Market Signal Arrive? Turning-Point Detection in Python
How Much Historical Stock Data Do You Need?
Does Mean Reversion Survive Trading Costs? Moving-Average Deviations in Python
How Much Does Survivorship Bias Add to a Backtest? Point-in-Time S&P 500 Returns in Python
Does High Profitability Persist? Five-Year Transition Analysis in Python
Log Returns vs Simple Returns: Which to Use
Does Mean-Variance Optimisation Beat Equal Weighting? Out-of-Sample Test in Python
Which Sectors Actually Drive "Sell in May"? Sector Seasonality Analysis in Python
Does Free Cash Flow Coverage Predict Dividend Cuts Better Than the Payout Ratio? Point-in-Time Screening in Python
Bulk Stock Data Download vs API: Which to Use
Does a Stock's Beta Depend on the Benchmark? Cap-Weighted vs Equal-Weighted Markets in Python
How Long Does a Volatility Spike Take to Fade? Half-Life Estimation in Python
How Much Does a DCF Depend on Its Assumptions? Sensitivity Analysis in Python
How to Get a List of All US Stock Tickers
Do High-Idiosyncratic-Volatility Stocks Underperform? Residual Volatility Sorts in Python
Does Foreign Revenue Make a Stock Dollar-Sensitive? Firm-Level FX Beta in Python
Does Company Size Slow Revenue Growth? Gibrat's Law Test in Python
How to Get Stock Data Into Excel With Python
Does a Large Goodwill Balance Predict a Writedown? Impairment Risk Screening in Python
Does Revenue Concentration Explain Earnings Volatility? Segment Herfindahl Analysis in Python
Is Residual Momentum Better Than Raw Momentum? Market-Adjusted Decile Sorts in Python
Financial Data API Rate Limits: How Much Do You Need?
Does Index-Fund Ownership Make a Stock Move With the Market? 13F Ownership and Beta in Python
What Is Look-Ahead Bias in Backtesting?
How Much Drawdown Does Month-End Data Hide? Sampling Frequency and Maximum Drawdown in Python
Do Companies Pay the Tax They Report? Cash vs Book Tax Rates in Python
Does a High Dividend Payout Ratio Slow Earnings Growth? S&P 500 Cross-Section in Python
Web Scraping vs a Financial Data API: What Breaks
Did Earnings or the Multiple Drive the Last Decade of Returns? Return Decomposition in Python
What Does a Trailing Stop Cost? Stop-Loss Backtest in Python
Why Do Stock Prices Differ Between Data Sources?
Does an Inventory Build Predict a Margin Squeeze? Cross-Sectional Test in Python
How Much Revenue Does a Dollar of Acquisitions Buy? Growth Decomposition in Python
Do Companies Buy Back Stock at Good Prices? Dollar-Weighted Analysis in Python
What Data You Need for Comparable Company Analysis
How Much Does a Stock Fall on Its Ex-Dividend Date? Event Study in Python
How Seasonal Is Quarterly Revenue? Fiscal Quarter Share Analysis in Python
Do Reported Financials Follow Benford's Law? First-Digit Analysis in Python
What Is Book Value? Why Price-to-Book Stopped Working
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

Does Revenue Breadth Predict the Stock Market? A Quarterly Diffusion Index in Python

What’s the question?

A diffusion index counts how many members of a group are moving in one direction instead of measuring how far the average moved. The ISM manufacturing survey works this way: its headline figure is the share of purchasing managers reporting better conditions, not the size of the improvement. Breadth measures are read as early warnings, on the reasoning that participation turns before magnitude does.

Company filings support the same construction without a survey. Take every member of the S&P 500, compare each fiscal quarter’s revenue against the same quarter a year earlier, and count the share that grew. That gives a quarterly reading of how widely revenue growth is spread across large American companies, and the question is where the reading sits in time relative to the stock market. If corporate revenue turns before prices do, the index is a forecasting input. If prices turn first, it is a record of something the market has already settled on.

The approach

The universe is the S&P 500 as it actually stood at each year end from 2004 to 2025, plus the current roster: 939 entities in the union, carried by entity id rather than ticker so a recycled symbol cannot swap one company for another mid-sample. Of those, 903 carry a quarterly revenue series long enough to form year-over-year comparisons, which produces 63,364 company-quarters.

  1. Pull quarterly revenue for every entity starting in 2003, one year before the sample opens, so the earliest quarter has something to compare against.
  2. For each company-quarter, compare revenue with the fourth quarter back, requiring the two period ends to fall 300 to 430 days apart so that a gap in a series cannot create a comparison spanning two years.
  3. The index for a calendar quarter is the share of companies whose fiscal quarter ended inside it and grew.
  4. The market is SPY total return, compounded within the same calendar quarters.
  5. Correlate the index, in level and in quarter-on-quarter change, against market returns from three quarters before to three quarters after.
  6. Repeat with 2008Q3 to 2009Q4 and all of 2020 removed, to see how much of the relationship lives in two crises.

A fiscal quarter’s reports reach the public record during the quarter that follows it, so k = +1 is the first column in which the index could inform a decision. Everything at k = 0 or earlier is hindsight.

Code

import numpy as np
import pandas as pd
from scipy import stats
import xfinlink as xfl

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

ids = set()
for year in range(2004, 2026):
    ids |= set(xfl.index("sp500", as_of=f"{year}-12-31")["entity_id"].dropna().astype(int))
ids |= set(xfl.index("sp500")["entity_id"].dropna().astype(int))
ids = sorted(ids)

f = pd.concat(
    [xfl.fundamentals(entity_id=ids[i:i + 60], period_type="quarterly",
                      start="2003-01-01", end="2026-09-10",
                      fields=["revenue"], max_rows=200000)
     for i in range(0, len(ids), 60)], ignore_index=True)

f = f.dropna(subset=["revenue", "period_end"]).drop_duplicates(["entity_id", "period_end"])
f = f.sort_values(["entity_id", "period_end"])
grp = f.groupby("entity_id")
f["prev"] = grp["revenue"].shift(4)
gap = (f["period_end"] - grp["period_end"].shift(4)).dt.days   # guard against a missing quarter
d = f[(f["prev"] > 0) & gap.between(300, 430)].copy()
d["grew"] = d["revenue"] > d["prev"]
d["q"] = d["period_end"].dt.to_period("Q")

D = d.groupby("q").agg(n=("grew", "size"), diffusion=("grew", "mean")).loc["2004Q1":"2026Q1"]

spy = xfl.prices("SPY", start="2003-06-01", end="2026-09-10", fields=["return_daily"])
spy["q"] = spy["date"].dt.to_period("Q")
mkt = spy.groupby("q")["return_daily"].apply(lambda x: (1 + x).prod() - 1)

t = D.join(mkt.rename("mkt"), how="inner")
t["dD"] = t["diffusion"].diff()

calm = t.copy()
for lo, hi in [("2008Q3", "2009Q4"), ("2020Q1", "2020Q4")]:
    calm = calm[(calm.index < pd.Period(lo)) | (calm.index > pd.Period(hi))]

def leadlag(frame, col):                    # corr(series at q, market return at q+k)
    out = []
    for k in range(-3, 4):
        a, b = frame[col], frame["mkt"].shift(-k)
        m = a.notna() & b.notna()
        r = np.corrcoef(a[m], b[m])[0, 1]
        out.append((k, r, r * np.sqrt((m.sum() - 2) / (1 - r ** 2))))
    return out

print(leadlag(t, "dD"), leadlag(t, "diffusion"))
print(leadlag(calm, "dD"), leadlag(calm, "diffusion"))

fwd = t.assign(nxt=t["mkt"].shift(-1)).dropna(subset=["dD", "nxt"])
reg = stats.linregress(fwd["dD"], fwd["nxt"])
print(reg.slope, reg.slope / reg.stderr, reg.rvalue ** 2, len(fwd))

Full script with formatting and visualisation: revenue-breadth-diffusion-index-market-python.py

Output

Quarterly revenue breadth across the S&P 500 against SPY quarterly returns from 2004 to 2026, and the correlation between changes in breadth and market returns at leads and lags of three quarters
Revenue breadth against the market, point-in-time S&P 500
Panel:   939 entities from the 2004-2025 year-end rosters plus the current
         roster; 903 carry a usable quarterly revenue series,
         63,364 company-quarters
Index:   share of companies whose fiscal quarter grew revenue against the
         same quarter a year earlier, grouped by calendar quarter of period end
Sample:  89 quarters, 2004Q1 to 2026Q1, 598 to 756 companies per quarter
Market:  SPY total return compounded within each calendar quarter

Index    mean 70.96%   sd 13.63%   low 27.53% (2009Q2)   high 88.50% (2021Q3)

Correlation with the market return k quarters away
  k                       -3      -2      -1      +0      +1      +2      +3
  change in index     +0.207  +0.226  +0.477  +0.304  -0.003  -0.106  -0.073
  t                    +1.94   +2.14   +5.03   +2.96   -0.03   -0.98   -0.67
  index level         +0.375  +0.267  +0.144  -0.118  -0.278  -0.275  -0.211
  t                    +3.70   +2.56   +1.35   -1.10   -2.68   -2.63   -1.98

Same, excluding 2008Q3-2009Q4 and 2020Q1-2020Q4 (79 quarters)
  change in index     +0.057  -0.016  +0.114  +0.141  -0.065  +0.172  -0.003
  t                    +0.49   -0.14   +1.00   +1.25   -0.57   +1.51   -0.03
  index level         +0.092  +0.036  -0.024  -0.118  -0.176  -0.202  -0.246
  t                    +0.80   +0.31   -0.21   -1.05   -1.56   -1.79   -2.19

The two turning points, quarter by quarter
  quarter      index    change    market
  2008Q3     73.68%    -4.71pt    -8.86%
  2008Q4     48.29%   -25.39pt   -21.57%
  2009Q1     29.69%   -18.60pt   -11.23%
  2009Q2     27.53%    -2.15pt   +16.28%
  2009Q3     30.34%    +2.81pt   +15.38%
  2020Q1     53.04%   -11.50pt   -19.43%
  2020Q2     34.26%   -18.77pt   +20.16%
  2020Q3     49.25%   +14.99pt    +9.04%

Next quarter's market return regressed on this quarter's change in the index
  beta -0.004   t -0.03   R2 0.0000   n 87

What this tells us

The index moves with the market’s past and not with its future. A one-quarter change in breadth correlates +0.477 with the market return of the quarter before it (t = 5.03) and +0.304 with the concurrent quarter. Looking forward, the correlations are -0.003, -0.106 and -0.073 at one, two and three quarters out, none of them distinguishable from zero. Regressing the next quarter’s market return on this quarter’s change in breadth gives a slope of -0.004, a t-statistic of -0.03, and an R-squared of 0.0000.

The level carries the opposite sign forward. High breadth follows strong markets, at +0.375 against the return three quarters earlier, and precedes slightly weaker ones, at -0.278 one quarter ahead (t = -2.68). A wide base of revenue growth describes where the cycle already is; it is not an argument for owning more equity.

Two crises carry most of the relationship. Removing 2008Q3 to 2009Q4 and all of 2020 leaves 79 quarters, and the backward correlation falls from +0.477 to +0.114 while the forward side stays near zero.

The quarter-by-quarter record shows why. Breadth was still at 73.68% in 2008Q3, a quarter in which the market fell 8.86%, and only then dropped 25.39 points in 2008Q4 and another 18.60 in 2009Q1. Its low of 27.53% arrived in 2009Q2, a quarter in which the market gained 16.28%. The 2020 sequence repeats the shape: a low of 34.26% in 2020Q2, alongside a 20.16% quarterly gain.

So what?

Revenue breadth is not a timing input. Zero forward correlation and an R-squared of 0.0000 leave nothing to trade on, and the version of this idea that reads a falling diffusion index as a sell signal is reacting to a number that troughs after the market has turned.

Its value is as a state variable. A reading far below the 70.96% sample mean identifies a real contraction in corporate revenue, which is useful for sizing risk and for deciding whether a drawdown has an earnings cause. Asking which sectors keep growing when breadth is at 30% is a question this series answers; asking what the market does next is not.

One caution about reading the series live. A quarter’s index is complete only once that quarter’s reports are in, which happens during the quarter after it. A partial reading taken mid-quarter is a different statistic, weighted toward whichever fiscal calendars report first.

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