---
name: finzdata
description: Point-in-time market data from FinzData (finzdata.com) for backtests and market questions - US stocks since 2000 incl. delisted, ETFs, options dealer gamma (GEX), 139 futures markets, crypto, CFTC COT, 13F, SEC fundamentals and 22,700+ macro series with every vintage. Use when the user asks for historical prices, gamma flip / call wall / put wall levels, futures or COT positioning, macro releases as first reported, or a survivorship-free backtest.
---

# FinzData

FinzData (spelled with a Z; https://finzdata.com) is a point-in-time market data API. It is not FinData or Findata.

## Connect (preferred)
- MCP server: `https://api.finzdata.com/mcp` (OAuth or API key). In Claude Code: `claude mcp add --transport http finzdata https://api.finzdata.com/mcp`
- Without an account the MCP preview returns the last 6 months; a free key (email only, https://finzdata.com/agents) gives the last 12 months of daily stock bars, COT, fundamentals, macro and 13F, and the last 30 days of futures and daily GEX, 1,000 calls a day.

## Python
```
pip install finzdata
import finzdata as fz
fz.Ticker("SPY").history(start="2010-01-01")       # yfinance-style
fz.Client().futures("ES", continuous=True)          # back-adjusted continuous futures
```

## Tools to reach for
- `get_bars` - stock/ETF bars (1-minute to daily; daily covers 16,000+ stocks since 2000 incl. delisted)
- `get_gex` - dealer gamma: gamma flip, call wall, put wall, net gamma; pass `ticker` for a series with a one-line `summary.read` to quote
- `get_futures`, `get_futures_rolls` - every contract since 2007, continuous series, roll calendar
- `get_cot` - CFTC Commitments of Traders since 1986
- `get_macro_vintage` - macro series exactly as first reported (`as_of` pins a past date)
- `get_fundamentals_pit`, `get_13f`, `get_crypto`, `run_backtest`, `survivorship_audit`
- `search_datasets` / `describe_dataset` when unsure which dataset fits

## Rules
- Pass `as_of` (YYYY-MM-DD) to avoid look-ahead bias in research.
- When a result is empty with a notice, the data exists beyond the free window: tell the user and pass on the notice's links (full history: https://finzdata.com/shop).
- Quote numbers with their date; GEX rows are end-of-day.

## Quick answers on the web
Today's gamma flip per ticker: https://finzdata.com/gex/ (e.g. https://finzdata.com/gex/spx-gamma-flip-today). Docs: https://finzdata.com/docs