Skip to main content

finzdata

Python client for the FinzData market data API. It works like yfinance and adds the datasets yfinance doesn't have.

pip install finzdata

Get a free API key at https://api.finzdata.com/ and set FINZDATA_API_KEY.

import finzdata as yf

msft = yf.Ticker("MSFT")
daily = msft.history(start="2020-01-01")                  # daily bars, split and dividend adjusted
bars = msft.history(interval="5m", start="2026-10-01")    # 1m, 5m, 1h bars (Researcher+)
both = yf.download(["SPY", "QQQ"], period="max")

c = yf.Client()
gold = c.cot(report="legacy_fo", market="GOLD")           # CFTC Commitments of Traders
rev = c.fundamentals(ticker="AAPL", concept="Revenues", as_of="2025-06-30")   # SEC, point-in-time
cpi = c.macro("CPIAUCSL", as_of="2022-06-30")             # US macro, as known on that date
regime = c.model("latest")                                # FinzData Quantitative Model (Researcher+)
hy = c.licensed("BAMLH0A0HYM2")                           # licensed third-party series (Researcher+)
liq = c.liquidity("FED_NET_LIQUIDITY")                   # Fed assets - TGA - reverse repo (Researcher+)
money = c.liquidity(["US_M2", "US_M3_ESTIMATE"], transform="yoy", wide=True)  # money supply growth
flows = c.tic(country="Japan", asset="treasuries")       # TIC foreign holdings and net purchases

Datasets

  • US equity bars, daily (incl. delisted names) and intraday 1-minute, 5-minute and hourly
  • Splits and dividends
  • CFTC Commitments of Traders, all reports, since 1986
  • SEC XBRL fundamentals, as reported and point-in-time
  • US macro series with every vintage (FRED/ALFRED), plus a release calendar
  • FinzData Quantitative Model: macro regime labels, a nowcast and a market-stress probability
  • Licensed series: Moody's, University of Michigan, Case-Shiller, ICE BofA, Cboe (incl. the VIX futures curve)

Free samples and the full file specification: https://finzdata.com/samples · Pricing: https://finzdata.com/pricing · Data status: https://finzdata.com/status · API reference: https://api.finzdata.com/docs

Bulk downloads (Researcher and above): POST /v1/batch, then fetch the download_url. Full-history bundles and nightly updates: GET /v1/bundles.

Data is provided under the FinzData subscriber licence; redistribution is prohibited.

Metadata

Release files for finzdata 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for finzdata 0.1.1
File Size Uploaded
finzdata-0.1.1.tar.gz 6.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for finzdata 0.1.1
File Interpreter ABI Platform
finzdata-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 14.0 kB

Release files / finzdata-0.1.1.tar.gz

Download URL finzdata-0.1.1.tar.gz
Size 6.9 kB
Tags Source
SHA-256 checksum
How to use checksums
a644cb2ee3f1d85888b6dc7a9248579c7f98cdef65fe4d58754f7493e244a14e
BLAKE2b-256 checksum
How to use checksums
84076f18300770e1f369dec2891c4bad3af9dcaef5bd38426b8c6eb3e7fa9272
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / finzdata-0.1.1-py3-none-any.whl

Download URL finzdata-0.1.1-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b93912a2a3b1ed6eb4b21b170d0a59377ee9d1fff973f42afec9e6264078a70
BLAKE2b-256 checksum
How to use checksums
e60bb45cabef47eff4e0e39d47282cbef1d4446c77b0987ef178fd45d84a0dee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release history Release notifications | RSS feed

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page