mkurman Overview
Fred API provides access to Federal Reserve Economic Data (FRED) — 800,000+ US and international economic time series. Use it for GDP, unemployment, inflation, interest rates, industrial production, and financial market data.
Installation
uv pip install fredapi
Basic Usage
from fredapi import Fred
fred = Fred(api_key="YOUR_API_KEY") # get free key from research.stlouisfed.org
# Get GDP data (series ID: GDP)
gdp = fred.get_series("GDP")
print(gdp.tail())
# Get unemployment rate
unemp = fred.get_series("UNRATE")
print(unemp.tail())
Search and Metadata
# Search for series
results = fred.search("consumer price index", limit=5)
print(results[["id", "title", "observation_start", "observation_end"]])
# Get series info
info = fred.get_series_info("CPIAUCSL") # CPI Urban Consumers
print(info)
Multiple Series
# Get multiple series at once
cpi = fred.get_series("CPIAUCSL")
fed_funds = fred.get_series("FEDFUNDS")
ten_year = fred.get_series("DGS10")
import pandas as pd
combined = pd.DataFrame({"CPI": cpi, "FedFunds": fed_funds, "10Y": ten_year})