Skip to main content

FinzData for DeepSeek

Built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.

FinzData gives DeepSeek point-in-time market data, macro vintages and server-side backtests through function calling and MCP — so the model answers market questions with real numbers it can cite, never guesses.

No API key needed

FinzData works the moment you install it: no FinzData account and no FinzData key. Your model gets the free AI preview (the last 6 months of data) automatically, and it knows to tell you when older or deeper data needs a key. When you want more, get a free API key (email only, 12 months of data) at https://finzdata.com/account, or full history at https://finzdata.com/shop, then set FINZDATA_API_KEY. Nothing else changes.

Install

pip install finzdata-deepseek

Quick start

from finzdata_deepseek import ask
print(ask("How did managed money positioning in crude oil change over the last 3 months?"))   # no FinzData key needed

What to ask

  • "How are speculators positioned in crude oil futures by the latest COT report?"
  • "Show SPY's dealer gamma, call wall and put wall for the last 30 sessions."
  • "What did the first-published CPI print say last month, before revisions?"
  • "Backtest a 12-month momentum strategy on US stocks, delisted names included."
  • "How many ships transited the Strait of Hormuz each day last month?"
  • "Who are the largest 13F holders of NVDA, and who added the most last quarter?"

Free strategies

Every strategy on the FinzData strategies page re-runs free on its full history (since 2000, delisted stocks included), on FinzData's servers, with no API key: ask the model to list the strategies and re-run one. Changing a strategy or testing your own idea over full history needs a purchase.

FinzData Workspace on Cloudflare

For an agent that keeps files and runs code next to the data between sessions, add the FinzData Workspace MCP server https://workspace.finzdata.com/mcp with a free FinzData key (email only, https://finzdata.com/account). Its strategy_run tool saves a strategy's spec and results into the workspace for analysis.

Command line

finzdata-deepseek "How did managed money positioning in crude oil change over the last 3 months?"
finzdata-deepseek --show-tools

DeepSeek API

Set DEEPSEEK_API_KEY and ask. The default model is deepseek-flash (DeepSeek V4.1 Flash), fast and inexpensive for tool calls; PRO_MODEL (deepseek-v4-pro) reasons more deeply for multi-step research. Override with model= or FINZDATA_DEEPSEEK_MODEL.

from finzdata_deepseek import ask, PRO_MODEL
ask("Compare dealer gamma on SPX and QQQ over the last month and explain what changed.", model=PRO_MODEL)

MCP

from finzdata_deepseek import mcp_config
print(mcp_config())

DeepSeek open weights

The DeepSeek models on Hugging Face (deepseek-ai/DeepSeek-V4-Pro, DeepSeek-V4.1-Flash) work through pip install finzdata-huggingface, or host them with vLLM (--enable-auto-tool-choice with the DeepSeek tool-call parser) and pass base_url="http://localhost:8000/v1".

Use with any OpenAI-compatible server

from finzdata_deepseek import openai_tools, FinzDataMCP
tools = openai_tools()          # pass as `tools=` to any chat.completions call
result = FinzDataMCP().call("get_cot", {"market": "crude"})   # run the tool the model picked

Tool profiles

lite (6 core tools, for small models), data (23 data, backtest and strategy tools, the default) and full (every read tool). Tools that change data on FinzData are never exposed unless you ask for them explicitly.

Coverage

16,000+ US stocks that have traded on NYSE and Nasdaq since January 2000, delisted included, point in time; 5,100+ ETFs; 139 futures markets with every contract since 2007; point-in-time options gamma (GEX) for single stocks, ETFs and the major indexes; CFTC COT since 1986; 13F holdings; SEC fundamentals as filed; end-of-day options chains; 22,700+ macro series with every vintage kept; 512 crypto pairs (Bitcoin since 2013); FX for 79 currency pairs; 123 indexes incl. the VIX term structure; tick trades for 1,100+ US stocks and ETFs; FinzData Global Macro Pulse (ship transits through 28 chokepoints, port calls, flights, toll traffic); 1, 5, 15, 30-minute, hourly and daily bars; server-side backtests.

Access

No key needed to start: AI/MCP use gives the last 6 months. A free account (email only, https://finzdata.com/account) gives the last 12 months of daily US stock bars, COT, SEC fundamentals, US macro and 13F, and the last 30 days of futures and daily GEX. Full history: https://finzdata.com/shop — $19 one ticker, $49 one futures market, $195 for 5 years of the whole US market.

With a key:

export FINZDATA_API_KEY=fz_...   # free at https://finzdata.com/account

or pass finzdata_api_key="fz_..." to ask.

Metadata

Release files for finzdata-deepseek 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-deepseek 0.1.1
File Size Uploaded Provenance Actions
finzdata_deepseek-0.1.1.tar.gz 15.1 kB Without provenance Details for finzdata_deepseek-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 28.8 kB

Release files / finzdata_deepseek-0.1.1.tar.gz

Download URL finzdata_deepseek-0.1.1.tar.gz
Size 15.1 kB
Tags Source
SHA-256 checksum
How to use checksums
73c452cd638e530d8cef72ddb00ef4793dd636a2d728deeeba311f463fbd8bb6
BLAKE2b-256 checksum
How to use checksums
0481729478d66446182afd3e005a95d7b72d09bce5521576df160c561fd71b37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

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

Download URL finzdata_deepseek-0.1.1-py3-none-any.whl
Size 13.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3a41e8c10addbe2c5f3e0fcddcf71238abe2052511cf03db2c62b104383f593d
BLAKE2b-256 checksum
How to use checksums
b0dbd9b6a7588ea4622ff95e59fec5e145ec601ba0bdc61f21dfbf019fea7455
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

Security for finzdata-deepseek 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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