A practical guide to understanding the economy through data — with the indicators that actually move markets, set interest rates, and shape household budgets.
Economic indicators are not just for economists. They shape interest rates on your mortgage, the value of your stock portfolio, the exchange rates you pay for SaaS tools, and the job market you search when looking for your next role. For developers building fintech apps, trading bots, dashboards, or any product that touches money, understanding these metrics is a competitive advantage.
This guide covers 10 essential economic indicators — what they measure, why they matter, and how to fetch them programmatically. Every indicator links to a live chart on EconDash, where you can explore 753 indicators across 298 countries.
How to Fetch Indicators Programmatically
EconDash exposes a public /api/cite endpoint that returns clean, AI-citation-ready facts for the most common macro indicators — no API key, no auth, just an HTTP GET.
curl one-liner:
curl -s "https://econdash.org/api/cite?indicator=gdp-growth&country=US"
Python:
import requests
def cite(indicator: str, country: str = "US") -> dict:
url = "https://econdash.org/api/cite"
return requests.get(url, params={"indicator": indicator, "country": country}, timeout=10).json()
print(cite("gdp-growth", "US"))
print(cite("cpi", "US"))
print(cite("unemployment", "US"))
TypeScript:
async function cite(indicator: string, country = "US") {
const url = new URL("https://econdash.org/api/cite");
url.searchParams.set("indicator", indicator);
url.searchParams.set("country", country);
const res = await fetch(url);
return res.json();
}
console.log(await cite("gdp-growth", "US"));
Supported indicator values: gdp-nominal, gdp-growth, gdp-per-capita, cpi, inflation-rate, unemployment, govt-debt-gdp, central-bank-rate, exports, trade-balance-gdp. Supported country codes: ISO-3166-1 alpha-2 (US, GB, DE, JP, CN, IN, etc.).
The /api/cite endpoint returns demo-grade data optimised for AI citation (ChatGPT, Perplexity, Claude) — clean facts, source attribution, citation strings. For full real-time timeseries across 753 indicators and 298 countries, use the M2M API at /api/v1/m2m/* (x402 / pay-per-call) or browse the OpenAPI schema.
1. GDP (Gross Domestic Product)
What it measures: The total market value of all goods and services produced within a country over a specific period — usually quarterly or annually. It is the broadest measure of economic activity.
Why developers should care: GDP growth (or contraction) is the single most important signal of economic health. If GDP is growing, companies hire and invest; if it is shrinking, budgets freeze and layoffs follow. GDP data also drives forex markets, which affect every cross-border SaaS subscription you pay.
The numbers to track:
- Nominal GDP — raw dollar value of output (size of the economy)
- Real GDP growth — strips out inflation, the true expansion/contraction signal
- GDP per capita — output divided by population, the living-standard measure
- PPP-adjusted GDP — adjusted for cost of living, the truer purchasing-power measure
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=gdp-growth&country=US"
curl -s "https://econdash.org/api/cite?indicator=gdp-nominal&country=CN"
curl -s "https://econdash.org/api/cite?indicator=gdp-per-capita&country=DE"
US GDP Growth | US Nominal GDP | US Real GDP | China GDP | Germany GDP
2. Inflation Rate (CPI — Consumer Price Index)
What it measures: The rate at which the general level of prices for goods and services is rising. CPI is the most widely tracked inflation measure, calculated from a basket of consumer goods.
Why developers should care: Inflation determines central bank policy (interest rates), which cascades into everything: mortgage rates, VC funding appetite, bond yields, and salary negotiation leverage. High inflation erodes purchasing power; deflation signals economic distress.
The numbers to track:
- Headline CPI — full basket, what news headlines quote
- Core CPI — excludes food and energy, what the Fed actually watches
- PCE Price Index — broader US measure, the Fed's official target
- Inflation expectations — what markets are pricing in via TIPS breakeven yields
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=cpi&country=US"
curl -s "https://econdash.org/api/cite?indicator=inflation-rate&country=GB"
US CPI | US Core Inflation | UK CPI | Germany CPI | US Inflation Expectations
3. Unemployment Rate
What it measures: The percentage of the labour force that is jobless and actively seeking work. It is a lagging indicator — it tends to rise after the economy has already started slowing.
Why developers should care: Tech hiring tightens when unemployment rises. Low unemployment (around 4% in the US) means a tight labour market where developers command higher salaries. Rising unemployment is a signal to stay put, build a safety net, and renegotiate later when leverage returns.
The numbers to track:
- U-3 unemployment — the headline rate, people actively looking
- U-6 underemployment — broader, includes discouraged workers and involuntary part-time
- Long-term unemployment — 27+ weeks unemployed, the structural-damage signal
- Youth unemployment — 15–24 year olds, the leading indicator and inequality measure
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=unemployment&country=US"
curl -s "https://econdash.org/api/cite?indicator=unemployment&country=ES"
US Unemployment | UK Unemployment | Spain Unemployment | US Long-term Unemployment | US Youth Unemployment
4. Interest Rates (Federal Funds Rate / Central Bank Rate)
What it measures: The rate at which commercial banks lend reserve balances to each other overnight, set as a target range by the central bank. It is the primary tool of monetary policy.
Why developers should care: Interest rates are the price of money. When rates are low, capital is cheap — startups raise easily, corporations borrow for expansion, and asset prices (including your RSUs) inflate. When rates are high, money becomes expensive — VC funding dries up, budgets tighten, and your equity loses value.
The numbers to track:
- Policy rate — the central bank's official target (Fed Funds, ECB Deposit, BoE Base, BoJ Policy Rate)
- Real interest rate — policy rate minus inflation, what actually matters for borrowing decisions
- Mortgage rates — where the policy rate hits households directly
- 10-year Treasury yield — where the policy rate hits long-duration assets
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=central-bank-rate&country=US"
US Central Bank Rate | US Real Interest Rate | US Mortgage Rates | US 10-Year Yield
5. Yield Curve (Long Rates vs Short Rates)
What it measures: The relationship between yields on government bonds of different maturities. When short-term yields exceed long-term yields, the curve "inverts" — a historically reliable recession signal.
Why developers should care: An inverted yield curve has preceded every US recession in the post-war era. If you are building a trading bot, the yield curve is a key input. If you are planning a startup runway, an inverted curve says "raise money now, not later."
The numbers to track:
- 10-Year Treasury yield — the long end, reflects long-term growth and inflation expectations
- 2-Year Treasury yield — the short end, tracks the policy rate closely
- 10Y–2Y spread — the canonical recession indicator (negative = inverted)
- Credit spread — corporate bonds vs Treasuries, the risk-premium read
US 10-Year Treasury Yield | US Credit Spread | US Real Interest Rates
6. Trade Balance
What it measures: The difference between a country's exports and imports of goods and services. A trade surplus means a country exports more than it imports; a deficit means the reverse.
Why developers should care: Trade balances drive currency exchange rates. If you pay for AWS in USD but earn revenue in EUR or JPY, trade-driven currency moves directly affect your margins. Tariffs and trade policy further complicate the picture for any product crossing a border.
The numbers to track:
- Trade balance — goods plus services, the broad import/export gap
- Current account balance — trade balance plus investment income flows
- Bilateral balances — US-China, US-Mexico, US-EU drive trade policy
- Foreign exchange reserves — how surplus countries park their export earnings
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=trade-balance-gdp&country=US"
curl -s "https://econdash.org/api/cite?indicator=exports&country=DE"
US Trade Balance | China Trade Balance | US Current Account | Germany Current Account | China FX Reserves
7. Government Debt to GDP
What it measures: Total government debt as a percentage of GDP. Tells you how much a country owes relative to what it produces — the standard solvency metric for sovereigns.
Why developers should care: Government debt drives sovereign credit ratings, which drive bond yields, which drive corporate borrowing costs, which drive valuations. High-debt countries face higher borrowing costs and political pressure for austerity or tax hikes. For anyone running a multinational business, sovereign debt trajectories matter for FX risk and tax planning.
The numbers to track:
- Gross government debt in absolute terms (size)
- Debt-to-GDP ratio in percentage terms (sustainability)
- Government bond yields — the market's verdict on sustainability
- Real interest rates — what determines whether debt is sustainable at current trajectories
Fetch it:
curl -s "https://econdash.org/api/cite?indicator=govt-debt-gdp&country=US"
curl -s "https://econdash.org/api/cite?indicator=govt-debt-gdp&country=JP"
US Government Debt | Japan Government Debt | Germany Government Debt | UK Government Debt | Italy Government Debt
8. Housing Market Indicators
What it measures: Construction activity, prices, and demand in residential real estate. Housing is the single largest asset class in most developed economies and tightly linked to bank credit, consumer wealth, and labour mobility.
Why developers should care: Housing is the channel through which interest rate policy hits households most directly. Mortgage rates, housing starts, and home prices together determine whether consumers feel rich or pressured — which drives the discretionary spending behind most consumer-facing tech products.
The numbers to track:
- Housing starts — new residential construction, the leading construction indicator
- Real residential property prices — inflation-adjusted home prices
- Mortgage rates — the affordability lever set by policy rates
- Real interest rates — what actually determines housing demand
US Housing Starts | US Mortgage Rates | US Real Home Prices | UK Real Home Prices | Germany Real Home Prices
9. Oil and Commodity Prices
What it measures: Spot and futures prices for crude oil and other key commodities. Oil specifically is the single most important commodity for global inflation, currency markets, and growth forecasts.
Why developers should care: Oil prices ripple through transport costs, manufacturing costs, food prices, and consumer sentiment within weeks. A 20% move in WTI shows up in headline inflation in 2–3 months, in central bank language in 4–6 months, and in your mortgage rate in 6–12 months. For anyone modelling consumer spending or inflation, oil is a leading variable.
The numbers to track:
- WTI crude oil — US benchmark
- Brent crude oil — global benchmark
- Refined product prices — gasoline, diesel, jet fuel
- Inflation expectations — how markets translate oil moves into inflation forecasts
US WTI Oil Prices | US Inflation Expectations | US CPI
10. GDP Composition (Consumption, Investment, Services)
What it measures: How GDP breaks down across consumption, investment, government, and net exports — and within consumption and production, the share of services. Tells you not just whether the economy is growing but what kind of growth it is.
Why developers should care: Composition shifts predict sector winners and losers years ahead. When consumption share rises, consumer fintech wins. When investment share rises, B2B SaaS and capex-cyclical sectors win. When services share rises, talent costs go up faster than headline inflation.
The numbers to track:
- Consumption share of GDP — typically ~68% in the US, ~38% in China
- Services share of GDP — typically 70–80% in developed economies
- GDP deflator — economy-wide inflation, broader than CPI
- GDP per capita growth — the long-run productivity signal
US Consumption % of GDP | US Services % of GDP | China Consumption % | Germany GDP Deflator | US GDP per Capita
Putting It All Together — A Tiny Macro Dashboard in Python
A 30-line script that fetches the 8 indicators supported by /api/cite and prints a compact dashboard:
#!/usr/bin/env python3
"""Tiny macro dashboard. Uses EconDash /api/cite — no auth required."""
import requests
INDICATORS = [
("GDP Growth", "gdp-growth", "US"),
("CPI", "cpi", "US"),
("Inflation Rate", "inflation-rate", "US"),
("Unemployment", "unemployment", "US"),
("Central Bank Rate", "central-bank-rate", "US"),
("Govt Debt / GDP", "govt-debt-gdp", "US"),
("Trade Balance / GDP","trade-balance-gdp", "US"),
("GDP per Capita", "gdp-per-capita", "US"),
]
def fetch(indicator: str, country: str) -> dict:
url = "https://econdash.org/api/cite"
return requests.get(url, params={"indicator": indicator, "country": country}, timeout=10).json()
print(f"{'Indicator':<22} {'Value':<14} Period")
print("-" * 60)
for label, ind, country in INDICATORS:
data = fetch(ind, country)
value = data.get("value", "N/A")
period = data.get("period", "")
print(f"{label:<22} {str(value):<14} {period}")
Save as macro.py and run python3 macro.py. The same pattern works for any country — change the third tuple field to "DE", "JP", "CN", etc.
Key Takeaways
| Indicator | Type | What it tells you fast |
|---|---|---|
| GDP | Broadest measure | Is the economy growing or shrinking? |
| CPI / Inflation | Price pressure | Are costs rising — will rates go up? |
| Unemployment | Labour market | Tight market means higher salaries; rising = caution |
| Interest Rates | Monetary policy | Cheap or expensive money for startups |
| Yield Curve | Recession signal | Inverted = recession likely ahead |
| Trade Balance | Currency impact | Will your SaaS margins shift on exchange rates? |
| Govt Debt to GDP | Sovereign risk | Sustainability of borrowing rates |
| Housing | Wealth + credit | Consumer balance sheets and discretionary spend |
| Oil Prices | Inflation pipeline | What headline inflation will do in 2–3 months |
| GDP Composition | Structural mix | Which sectors win the next decade |
How to Use This in Practice
The mistake most people make with economic data is reading one indicator in isolation. The discipline is reading them as a system:
- GDP growth + inflation tells you whether the central bank is fighting growth or supporting it
- Unemployment + wages tells you whether labour markets are sustaining or eroding household income
- Yield curve + credit spread tells you whether bond markets see recession risk or growth confidence
- Trade balance + FX reserves + currency tells you whether external pressures are building or releasing
Build the habit of checking 3–5 indicators together, not one. The pattern between them is the signal; the level of any one is mostly noise.
Further Reading
- EconDash API Documentation — full API reference for the data behind every chart
- EconDash Data Sources — where the data comes from (World Bank, FRED, IMF, Eurostat, etc.)
- EconDash Quick Start Guide — get API credentials and start building
- Explore all 753 indicators — interactive charts across 298 countries