Back to glossary
Factors, macro, and AI/API
Economic Surprise explained for investors
Economic surprise is about expectations, not whether the number is objectively good or bad.
Get Free API KeyUpdated June 18, 2026
Definition
Economic surprise measures the difference between a released macro value and expected value, often consensus. Some systems scale the difference by historical volatility or forecast dispersion.
Formula
actual released value - consensus expectation
Investor read
Markets move on the gap between reality and expectations. A strong number can be bearish if it raises rates, and a weak number can be bullish if it lowers policy risk.
Where it appears
- Macro release and forecast workflows.
- Event calendars, country reports, and factor regime analysis.
- Rates, FX, equity factor, and portfolio-risk reviews.
SEC API workflow
- Pull upcoming releases, expected values, prior values, and actual releases.
- Calculate or inspect the surprise after release.
- Tie surprise to affected factors, sectors, countries, or portfolio holdings.
Common traps
- Ignoring revisions to prior releases.
- Using stale consensus values.
- Assuming directionality is stable across regimes.
Key takeaways
- Economic surprise is actual minus expected.
- The market reaction depends on regime and asset sensitivity.
- Release metadata and freshness are central.