calcfidata 0.1.0

Python client for CalcFi Open Data — 34 CC-BY financial and macroeconomic time series mirrored from primary sources (FRED, BLS, Freddie Mac, US Treasury, BEA, World Bank)

calcfidata

Python client for CalcFi Open Data — 34 free CC-BY financial and macroeconomic time series mirrored from primary sources (FRED, BLS, Freddie Mac, US Treasury, BEA, World Bank, Federal Reserve).

Install

pip install calcfidata

Quick start

import calcfidata as cf

# load a single series
df = cf.load("30-year-fixed")
print(df.tail())

# list every available series
catalog = cf.list_series()
print(catalog.head())

# load several series joined on date
inflation = cf.multi(["cpi", "pce"], align_on="inner")
print(inflation.tail())

# get the Frictionless datapackage metadata for any series
meta = cf.metadata("cpi")
print(meta["sources"][0]["title"])

What's included

34 time series across:

• Mortgage rates — 30-year, 15-year fixed (Freddie Mac PMMS)
• Treasury yields — 2Y, 10Y constant maturity (US Treasury)
• Fed Funds + Prime + credit-card APR (Federal Reserve)
• Inflation — CPI-U, PCE, world inflation (BLS, BEA, World Bank)
• Employment — unemployment rate, labor-force participation, hourly earnings (BLS)
• Energy — WTI, Brent crude, US regular gasoline (EIA)
• FX — USD/EUR, USD/GBP, USD/JPY (Federal Reserve H.10)
• Commodities — copper, corn (World Bank)
• Macro — US + Eurozone GDP per capita, world unemployment (World Bank)
• Consumer credit — credit card APR, personal loan, auto loan rates (Fed G.19)
• Crypto — Bitcoin, Ethereum, Solana (CoinGecko — snapshot-only currently)
• Deposit rates — savings, money-market, CDs (FDIC — snapshot-only currently)

Each series carries primary-source provenance in the # Source: and # Primary URL: comment headers of its CSV.

Methodology + citation

• Methodology paper: under review at SSRN, published as a working paper at https://calcfi-open-data-4a2bc1.gitlab.io/methodology.html
• Mirrors: Hugging Face · GitHub · GitLab
• Permanent DOIs: Figshare · Zenodo · OSF · Kaggle · Mendeley
• Companion visualizations: 10 Hugging Face Spaces · 3 Observable notebooks · 6 CodePen demos · Live SQL Datasette

Citation

@dataset{salmisto_2026_calcfi_open_data,
  author       = {Salmisto, Jere},
  title        = {CalcFi Open Data: 34 Free CC-BY Financial and Macro Time Series Mirrored from Primary Sources},
  year         = 2026,
  publisher    = {Figshare},
  doi          = {10.6084/m9.figshare.32332290},
  url          = {https://doi.org/10.6084/m9.figshare.32332290},
  orcid        = {0009-0000-0916-8684},
  license      = {CC-BY-4.0}
}

Salmisto, J. (2026). CalcFi Open Data: 34 Free CC-BY Financial and Macro Time Series Mirrored from Primary Sources [Dataset]. Figshare. https://doi.org/10.6084/m9.figshare.32332290

License

• Package code: MIT
• Underlying data: CC BY 4.0 — attribution to CalcFi and the named primary source for each series

Live tools

For 300+ free personal-finance calculators built on the same primary-source data layer, see calcfi.app.