Macro Economic Oracle

Updated: 2026-02-13 | Version: 4.0.0 | 86 FRED Series · 20 ECB Series · 54 API Endpoints

FRED Series

ECB Series

API Endpoints

Authentication

Public — No API key required for macro endpoints.

Base URL: https://api.feedoracle.io/api/v1/macro/

Core Economic Indicators

GDP, inflation, employment, Fed policy, recession risk.

GET /health

Economic Health Index (0-100): EXPANSION / STABLE / CAUTION / CONTRACTION

GET /fed

Fed Funds Rate, FOMC calendar, rate outlook, last change

GET /inflation

CPI YoY, Core CPI, PCE, MoM change, target deviation

GET /employment

Unemployment rate, nonfarm payrolls, labor force participation

GET /gdp

Real GDP growth QoQ annualized, nominal GDP

GET /sentiment

Consumer sentiment, Michigan survey, expectations

GET /risk

Recession probability, risk assessment, leading indicators

GET /yields

Key Treasury yields summary (2Y, 10Y, 30Y, 2s10s spread)

GET /all

All core indicators combined in single response

Treasury Yield Curve

Full US Treasury curve from 1M to 30Y, spread analysis, TIPS real yields.

GET /yield-curve

Full curve: 1M, 3M, 6M, 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y, 30Y + shape

GET /yield-curve/spreads

2s10s, 3M-10Y, 5s30s, term premium, inversion signals

GET /yield-curve/tips

TIPS 5Y, 10Y, 20Y, 30Y — real yields and breakeven inflation

Credit & Lending Rates

SOFR, credit spreads, bank lending, Fed overnight rates.

GET /sofr

SOFR rate, effective date, benchmark status

GET /credit

AAA/BAA yields, BAA-AAA spread, prime rate, risk assessment

GET /lending

C&I loan rates, bank lending standards, tightening index

GET /fed-rates NEW

EFFR, OBFR, Reverse Repo (ON RRP) — overnight funding

Commodities

Energy, precious metals, industrial metals, gas prices.

GET /commodities

All commodities: energy + metals combined overview

GET /commodities/energy

WTI, Brent crude, natural gas, gasoline, propane

GET /commodities/metals

Gold, silver, copper price indices

Stock Market Indices

S&P 500, NASDAQ, Dow Jones — major US equity benchmarks.

GET /equities

All three indices: S&P 500, NASDAQ Composite, Dow Jones

GET /equities/{symbol}

Single index: sp500, nasdaq, or dow

Crypto Reference Prices

BTC/USD and ETH/USD via FRED (Coinbase reference).

GET /crypto

Bitcoin + Ethereum prices, 24h change, market status

GET /crypto/{symbol}

Single asset: btc or eth

Financial Stress & Volatility

VIX, St. Louis Financial Stress Index, TED spread, HY spreads.

GET /stress

Composite stress score (0-100), VIX, STLFSI, TED, HY spread

GET /volatility

CBOE VIX detail, regime classification, historical context

GET /expectations

Michigan inflation expectations, consumer confidence

Real Estate & Housing

Case-Shiller, FHFA HPI, mortgage rates, housing starts, permits.

GET /realestate

Full overview: prices, rates, activity metrics

GET /realestate/prices

Case-Shiller National, FHFA HPI, median home price

GET /realestate/mortgage

30Y and 15Y fixed rates, ARM rates, refinancing index

Federal Debt & Fiscal

US federal debt, budget deficit, foreign holdings, trade balance.

GET /fiscal

Overview: total debt, deficit, debt-to-GDP, foreign holdings

GET /fiscal/debt

Federal debt total, foreign held, Debt/GDP ratio

GET /fiscal/trade

Trade balance, USD index, monetary base

Business & Industrial

Industrial production, capacity utilization, loan delinquency, consumer credit.

GET /business

Overview: production, utilization, credit, delinquency rates

GET /business/production

Industrial production index, capacity utilization

GET /business/credit

Commercial loans, consumer credit, delinquency rates

International Bonds & FX

German Bunds, UK Gilts, JGB, sovereign spreads, 10 FX pairs via FRED.

GET /international/bonds

Germany 10Y, UK 10Y, Japan 10Y benchmark yields

GET /international/fx

EUR, GBP, JPY, CHF, CNY, KRW, MXN, INR, BRL vs USD

GET /international/spreads

US-DE, US-UK, US-JP sovereign yield spreads

European Central Bank (ECB)

Direct from ECB Data Portal — 20 series: rates, FX, inflation, economy, yields.

GET /ecb

ECB overview: key rates, EUR/USD, HICP, GDP, unemployment

GET /ecb/rates

Refi rate, deposit rate, marginal lending, eSTR, EURIBOR 3M/6M/12M

GET /ecb/fx

EUR vs USD, GBP, JPY, CHF, CNY — EUR strength index

GET /ecb/inflation

EA HICP, core HICP, Germany HICP, target assessment

GET /ecb/economy

EA GDP growth, unemployment, M3 money supply

GET /ecb/yields

EA 10Y AAA government bond yield, real yield

GET /ecb/series/{id}

Any of the 20 ECB series by ID (e.g. eur_usd, deposit_rate)

Verified & Proofs

Cryptographically signed responses with SHA-256 hashes and XRPL blockchain anchoring.

GET /verified/health

Health index with ECDSA signature + content hash

GET /verified/all

All indicators with full evidence envelope

GET /proofs

Latest proof anchors and verification links

GET /verification-status

Signing key status, anchor chain, JWKS endpoint

Example

Request

curl https://api.feedoracle.io/api/v1/macro/ecb

Response

{
  "feed": "ECB_OVERVIEW",
  "key_rates": {
    "refi_rate": 2.15,
    "deposit_rate": 2.0,
    "estr": 1.93
  },
  "fx": {
    "eur_usd": 1.1874,
    "date": "2026-02-12"
  },
  "inflation": {
    "hicp_yoy_pct": 1.9,
    "date": "2025-12"
  },
  "economy": {
    "gdp_growth_yoy_pct": 1.318,
    "unemployment_pct": 6.2
  },
  "data_source": "European Central Bank (ECB Data Portal)",
  "oracle_ready": true
}

FRED Series Coverage (86)

Category	Series	#
Interest Rates	FEDFUNDS, DFF, DFEDTARU, DFEDTARL, SOFR, EFFR, OBFR, RRPONTSYD, PRIME, DPRIME	10
Treasury Yields	DGS1MO, DGS3MO, DGS6MO, DGS1, DGS2, DGS3, DGS5, DGS7, DGS10, DGS20, DGS30	11
TIPS	DFII5, DFII10, DFII20, DFII30	4
Credit	AAA, BAA, BAMLC0A0CM, BAMLH0A0HYM2, TEDRATE	5
Inflation	CPIAUCSL, CPILFESL, CPILFENS, PCEPI, PCEPILFE, MICH	6
Growth & Labor	GDP, GDPC1, UNRATE, PAYEMS, A067RC1Q156SBEA, CIVPART, UMCSENT	7
Commodities	DCOILWTICO, DCOILBRENTEU, DHHNGSP, GASREGW, DPROPANEMBTX, NASDAQQGLDI, NASDAQQSLVO, PCOPPUSDM	8
Real Estate	CSUSHPINSA, USSTHPI, MORTGAGE30US, MORTGAGE15US, HOUST, PERMIT, MSPUS	7
Equities	SP500, NASDAQCOM, DJIA	3
Crypto	CBBTCUSD, CBETHUSD	2
Fiscal	GFDEBTN, FYFSD, FDHBFIN, BOPGSTB, DTWEXBGS, BOGMBASE	6
Business	INDPRO, TCU, BUSLOANS, TOTALSL, DRSFRMACBS	5
Intl Bonds	IRLTLT01DEM156N, IRLTLT01GBM156N, IRLTLT01JPM156N	3
FX (FRED)	DEXUSEU, DEXUSUK, DEXJPUS, DEXSZUS, DEXCHUS, DEXKOUS, DEXMXUS, DEXINUS, DEXBZUS	9

ECB Series Coverage (20)

Category	Series
Key Rates	Main Refinancing, Deposit Facility, Marginal Lending, eSTR
EURIBOR	3-Month, 6-Month, 12-Month
Exchange Rates	EUR/USD, EUR/GBP, EUR/JPY, EUR/CHF, EUR/CNY
Inflation	EA HICP, Core HICP, Germany HICP
Economy	EA GDP Growth, EA Unemployment
Bonds & Money	EA 10Y AAA Yield, M3 Money Supply

Data Sources

Federal Reserve Economic Data (FRED) — fred.stlouisfed.org · 86 series · Public domain

European Central Bank (ECB Data Portal) — data-api.ecb.europa.eu · 20 series · SDMX 2.1 REST · No API key

On-Chain Integration

All endpoints include oracle_ready: true when data quality is sufficient for on-chain use. Available via Chainlink Functions on Polygon (Subscription #185).

Rate Limits

Plan	Calls/day	Proofs/month
Free	100	—
Developer (€49/mo)	5,000	50
Professional ($299/mo)	25,000	500
Enterprise	Custom	Unlimited

← Back to Docs · Live Dashboard · Pricing