Skip to content

About

Free US macro data packages by category (inflation, labor, rates, consumer credit, consumption and more), ready for pandas. Full point-in-time history via the FinzData API.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FinzData macro data

Series Point in time PyPI

Free, ready-to-use US and international macroeconomic data: 9,636 series in 25 categories, one folder per category, each loading in one line of pandas. No API key, no sign-up, no scraping.

import pandas as pd
df = pd.read_csv("https://raw.githubusercontent.com/FinzData/macro-data/main/inflation/long.csv", parse_dates=["date"])

Categories

Category Series Folder Parquet on Hugging Face
Energy 2,020 energy/ FinzData/macro-energy
Consumption 1,602 consumption/ FinzData/macro-consumption
Trade 1,430 trade/ FinzData/macro-trade
Inflation 959 inflation/ FinzData/macro-inflation
Labor 595 labor/ FinzData/macro-labor
Other Indicators 363 other-indicators/ FinzData/macro-other-indicators
Liquidity 340 liquidity/ FinzData/macro-liquidity
Consumption, International 326 consumption-international/ FinzData/macro-consumption-international
Housing 273 housing/ FinzData/macro-housing
Rates 271 rates/ FinzData/macro-rates
Electricity 245 electricity/ FinzData/macro-electricity
Consumer Credit 184 consumer-credit/ FinzData/macro-consumer-credit
Money and Credit 182 money-credit/ FinzData/macro-money-credit
Income and Spending 166 income-spending/ FinzData/macro-income-spending
Productivity 137 productivity/ FinzData/macro-productivity
Production 120 production/ FinzData/macro-production
Growth 105 growth/ FinzData/macro-growth
FX 81 fx/ FinzData/macro-fx
Commodities 59 commodities/ FinzData/macro-commodities
Other 59 other/ FinzData/macro-other
Orders and Trade 50 orders-trade/ FinzData/macro-orders-trade
Financial Conditions 39 financial-conditions/ FinzData/macro-financial-conditions
Population 13 population/ FinzData/macro-population
Recession 13 recession/ FinzData/macro-recession
Ai Adoption 4 ai-adoption/ FinzData/macro-ai-adoption

Each folder holds long.csv (series_id, date, value), series.csv (titles, units, frequency, seasonal adjustment, start of full history, last update), top_series.csv and a 10-row sample.csv.

What is free here, and what the API adds

This repository (free) FinzData API
Values latest revised values latest values and every vintage
History last 12 months full history of every series
Updates weekly same day, as each release lands
Point in time (as_of) no yes: what was known on any past date
Release calendar no yes
Formats CSV, Parquet JSON, CSV, Parquet, pandas, MCP for AI agents

Why vintages matter

Macro numbers are revised, often a lot. A backtest that uses today's revised payrolls or GDP for a 2020 decision uses numbers nobody had in 2020. FinzData keeps every vintage, so you can ask for a series as it stood on any date:

import finzdata as fz          # pip install finzdata ; free key: https://api.finzdata.com/
c = fz.Client()
as_known = c.macro("CPIAUCSL", as_of="2020-05-01")   # CPI as published by that date
latest   = c.macro("CPIAUCSL")                       # after every revision since

AI agents get the same data through the MCP server at https://api.finzdata.com/mcp (tool get_macro_vintage).

Update schedule

Refreshed weekly from the source agencies. The API updates each series the day it is released; see data freshness at https://finzdata.com/status.

Source and license

U.S. government agencies via FRED and ALFRED (Federal Reserve Bank of St. Louis). Only public-domain series are included; series with third-party copyright are excluded. Packaging and documentation: CC BY 4.0, attribution "FinzData". Research data, not investment advice.

Links: Pricing · Python client · Strategies built on this data · Docs

About

Free US macro data packages by category (inflation, labor, rates, consumer credit, consumption and more), ready for pandas. Full point-in-time history via the FinzData API.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors