FinzData for Open Models: market data for Qwen, Kimi, GLM, DeepSeek and more, no API key needed

README.md

@@ -1,10 +1,42 @@
 ---
-title: Finzdata Open Models
-emoji: 🏆
+title: FinzData for Open Models
+emoji: 📈
 colorFrom: blue
-colorTo: purple
+colorTo: indigo
 sdk: static
-pinned: false
+app_file: index.html
+pinned: true
+license: mit
+short_description: Market data for Qwen, Kimi, GLM, DeepSeek & more, no key
+tags:
+  - finance
+  - market-data
+  - mcp
+  - function-calling
+  - qwen
+  - kimi
+  - glm
+  - deepseek
+  - llama
+  - backtesting
+  - agents
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# FinzData for Open Models
+
+Built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.
+
+Give Qwen, Kimi, GLM, DeepSeek, Llama, gpt-oss, Gemma, MiniMax and Mistral point-in-time market data, macro vintages and server-side backtests through function calling and MCP. **No FinzData API key needed to start** — models get the free AI preview (the last 6 months). For more, a free API key (email only) at https://finzdata.com/account gives 12 months; full history at https://finzdata.com/shop.
+
+**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; SEC fundamentals as filed; 22,700+ macro series with every vintage; 512 crypto pairs; 79 FX pairs; 123 indexes; FinzData Global Macro Pulse; tick to daily bars; server-side backtests.
+
+| Package | For |
+|---|---|
+| `pip install finzdata-huggingface` | Inference Providers, smolagents, Tiny Agents — every top Hub model |
+| `pip install finzdata-qwen` | Qwen via DashScope and Qwen-Agent |
+| `pip install finzdata-kimi` | Kimi via the Moonshot API and the Kimi CLI |
+| `pip install finzdata-glm` | GLM via the Z.ai API |
+| `pip install finzdata-deepseek` | DeepSeek via its API |
+| `pip install finzdata-ollama` | Any open model on your own machine |
+
+MCP server: `https://api.finzdata.com/mcp` · [finzdata.com](https://finzdata.com) · [Docs](https://finzdata.com/docs) · the FinzData team, info@finzdata.com

index.html

@@ -1,19 +1,132 @@
 <!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>FinzData for Open Models</title>
+<meta name="description" content="Give Qwen, Kimi, GLM, DeepSeek, Llama, gpt-oss, Gemma, MiniMax and Mistral point-in-time market data, macro and backtests through function calling and MCP. No API key needed to start.">
+<style>
+:root{--navy:#1f3a5f;--navy-2:#2c5282;--slate:#64748b;--ink:#0f172a;--muted:#475569;--line:#e2e8f0;--bg:#ffffff;--soft:#f5f8fc;--code:#0b1726;--code-ink:#e6edf6;--accent:#0e7c66}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Inter,Roboto,Helvetica,Arial,sans-serif}
+a{color:var(--navy-2)}
+.wrap{max-width:980px;margin:0 auto;padding:0 20px}
+header{padding:40px 0 8px}
+.mark{font-size:30px;font-weight:800;letter-spacing:-.5px}
+.mark .f{color:var(--navy)} .mark .d{color:var(--slate);font-weight:600}
+.tag{color:var(--muted);margin:4px 0 0}
+h1{font-size:clamp(28px,4.4vw,42px);line-height:1.15;margin:28px 0 12px;letter-spacing:-.6px}
+.lead{font-size:18px;color:var(--muted);max-width:760px}
+.pill{display:inline-block;background:#e8f5f1;color:var(--accent);border:1px solid #b8e2d6;border-radius:999px;padding:6px 14px;font-weight:700;font-size:14px;margin:18px 0 6px}
+section{padding:26px 0;border-top:1px solid var(--line)}
+h2{font-size:22px;margin:0 0 12px}
+.tabs{display:flex;flex-wrap:wrap;gap:8px;margin:10px 0 14px}
+.tabs button{border:1px solid var(--line);background:var(--soft);color:var(--ink);padding:8px 14px;border-radius:8px;font:600 14px/1 inherit;cursor:pointer}
+.tabs button[aria-selected=true]{background:var(--navy);border-color:var(--navy);color:#fff}
+pre{background:var(--code);color:var(--code-ink);padding:16px 18px;border-radius:10px;overflow-x:auto;font:13.5px/1.55 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;margin:0}
+.code{position:relative}
+.copy{position:absolute;top:8px;right:8px;background:#22344d;color:#dbe7f5;border:0;border-radius:6px;padding:5px 10px;font:600 12px/1 inherit;cursor:pointer}
+.note{color:var(--muted);font-size:14px;margin:10px 0 0}
+.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:12px}
+.card{border:1px solid var(--line);border-radius:10px;padding:14px 16px;background:#fff}
+.card b{display:block;margin-bottom:4px}
+ul.q{padding-left:20px;margin:0} ul.q li{margin:4px 0}
+.ds{display:flex;flex-wrap:wrap;gap:8px}
+.ds a{font-size:13px;border:1px solid var(--line);border-radius:999px;padding:4px 10px;text-decoration:none;background:var(--soft)}
+footer{border-top:1px solid var(--line);padding:24px 0 40px;color:var(--muted);font-size:14px}
+@media (max-width:560px){h1{margin-top:20px}.lead{font-size:16px}}
+</style>
+</head>
+<body>
+<div class="wrap">
+<header>
+  <div class="mark"><span class="f">Finz</span><span class="d">Data</span></div>
+  <p class="tag">Built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.</p>
+</header>
+
+<h1>Market data for every open model</h1>
+<p class="lead">Give Qwen, Kimi, GLM, DeepSeek, Llama, gpt-oss, Gemma, MiniMax and Mistral point-in-time market data, macro vintages and server-side backtests through plain function calling. Your model fetches real numbers, cites the dataset, and never has to guess.</p>
+<span class="pill">No API key needed to start</span>
+<p class="note">Install and ask: your model gets FinzData's free AI preview (the last 6 months of data) with no account and no FinzData key. For more, a free API key (email only) at <a href="https://finzdata.com/account">finzdata.com/account</a> gives 12 months; full history is at <a href="https://finzdata.com/shop">finzdata.com/shop</a>. Then set <code>FINZDATA_API_KEY</code>. Nothing else changes.</p>
+
+<section>
+  <h2>Pick your model</h2>
+  <div class="tabs" role="tablist" id="tabs"></div>
+  <div class="code"><button class="copy" id="copy">Copy</button><pre id="snippet"></pre></div>
+  <p class="note" id="snote"></p>
+</section>
+
+<section>
+  <h2>Any MCP-capable agent</h2>
+  <div class="code"><button class="copy" data-for="mcp">Copy</button><pre id="mcp">{
+  "mcpServers": {
+    "finzdata": { "url": "https://api.finzdata.com/mcp", "type": "streamable-http" }
+  }
+}</pre></div>
+  <p class="note">Works with Qwen-Agent, the Kimi CLI, Tiny Agents, smolagents and any client that speaks MCP. No key needed for the free preview.</p>
+</section>
+
+<section>
+  <h2>What to ask</h2>
+  <ul class="q">
+    <li>How are speculators positioned in crude oil futures by the latest COT report?</li>
+    <li>Show SPY's dealer gamma, call wall and put wall for the last 30 sessions.</li>
+    <li>What did the first-published CPI print say last month, before revisions?</li>
+    <li>Backtest a 12-month momentum strategy on US stocks, delisted names included.</li>
+    <li>How many ships transited the Strait of Hormuz each day last month?</li>
+    <li>Who are the largest 13F holders of NVDA, and who added the most last quarter?</li>
+  </ul>
+</section>
+
+<section>
+  <h2>Coverage</h2>
+  <div class="grid">
+    <div class="card"><b>US equities</b>16,000+ US stocks that have traded on NYSE and Nasdaq since January 2000, delisted included, point in time. 5,100+ ETFs.</div>
+    <div class="card"><b>Futures and options</b>139 futures markets with every contract since 2007. Point-in-time options gamma (GEX) for single stocks, ETFs and the major indexes. End-of-day options chains.</div>
+    <div class="card"><b>Positioning and filings</b>CFTC COT since 1986, 13F holdings, insider transactions, SEC fundamentals as filed.</div>
+    <div class="card"><b>Macro</b>22,700+ macro series with every vintage kept, plus FinzData Global Macro Pulse: ship transits through 28 chokepoints, port calls, flights and toll traffic.</div>
+    <div class="card"><b>Crypto, FX, indexes</b>512 crypto pairs (Bitcoin since 2013), 79 FX pairs, 123 indexes incl. the VIX term structure.</div>
+    <div class="card"><b>Every bar size</b>Tick trades for 1,100+ US stocks and ETFs; 1, 5, 15, 30-minute, hourly and daily bars; server-side backtests.</div>
+  </div>
+</section>
+
+<section>
+  <h2>FinzData datasets on Hugging Face</h2>
+  <div class="ds" id="ds"></div>
+</section>
+
+<footer>
+  <a href="https://finzdata.com">finzdata.com</a> · <a href="https://finzdata.com/docs">Docs</a> · <a href="https://finzdata.com/agents">For AI agents</a> · <a href="https://finzdata.com/shop">Full history</a> · MCP: <code>https://api.finzdata.com/mcp</code><br>
+  The FinzData team · info@finzdata.com
+</footer>
+</div>
+<script>
+const Q = "How did managed money positioning in crude oil change over the last 3 months?";
+const M = [
+ {k:"Hugging Face", pkg:"finzdata-huggingface", note:"One HF token reaches every top open model through Inference Providers. Also: smolagents (smolagents_agent) and Tiny Agents (finzdata-huggingface --write-tiny-agent).",
+  code:`pip install finzdata-huggingface\nexport HF_TOKEN=hf_...            # your Hugging Face token\n\nfrom finzdata_huggingface import ask\n# model: "glm", "kimi", "qwen", "deepseek", "llama", "gpt-oss", "gemma", "minimax" or any Hub id\nprint(ask("${Q}", model="glm"))`},
+ {k:"Qwen", pkg:"finzdata-qwen", note:"DashScope by default (Singapore; FINZDATA_QWEN_REGION=us or cn). Qwen-Agent: pip install \"finzdata-qwen[qwen-agent]\" then qwen_assistant(). Local Qwen: local(question).",
+  code:`pip install finzdata-qwen\nexport DASHSCOPE_API_KEY=sk-...\n\nfrom finzdata_qwen import ask\nprint(ask("${Q}"))`},
+ {k:"Kimi", pkg:"finzdata-kimi", note:"Moonshot API, default model kimi-k3. Kimi CLI: finzdata-kimi --install-cli-config adds FinzData to ~/.kimi/mcp.json.",
+  code:`pip install finzdata-kimi\nexport MOONSHOT_API_KEY=sk-...\n\nfrom finzdata_kimi import ask\nprint(ask("${Q}"))`},
+ {k:"GLM", pkg:"finzdata-glm", note:"Z.ai API, default model glm-5.3 (FINZDATA_GLM_REGION=cn for the mainland endpoint).",
+  code:`pip install finzdata-glm\nexport ZAI_API_KEY=...\n\nfrom finzdata_glm import ask\nprint(ask("${Q}"))`},
+ {k:"DeepSeek", pkg:"finzdata-deepseek", note:"Default deepseek-flash; PRO_MODEL (deepseek-v4-pro) for deeper multi-step research.",
+  code:`pip install finzdata-deepseek\nexport DEEPSEEK_API_KEY=sk-...\n\nfrom finzdata_deepseek import ask\nprint(ask("${Q}"))`},
+ {k:"Local (Ollama, vLLM)", pkg:"finzdata-ollama", note:"Any open model on your own machine: Ollama by default, or server=\"vllm\" / \"lmstudio\" / \"llamacpp\". No keys at all.",
+  code:`pip install finzdata-ollama\nollama pull qwen3:8b\n\nfrom finzdata_ollama import ask\nprint(ask("${Q}"))`},
+];
+const tabs=document.getElementById('tabs'), sn=document.getElementById('snippet'), note=document.getElementById('snote');
+function pick(i){ [...tabs.children].forEach((b,j)=>b.setAttribute('aria-selected', j===i)); sn.textContent=M[i].code;
+  note.innerHTML = M[i].note + ' <a href="https://pypi.org/project/'+M[i].pkg+'/">'+M[i].pkg+' on PyPI</a>'; }
+M.forEach((m,i)=>{const b=document.createElement('button'); b.textContent=m.k; b.setAttribute('role','tab'); b.onclick=()=>pick(i); tabs.appendChild(b);});
+pick(0);
+function copyText(t,btn){ try{ navigator.clipboard.writeText(t); btn.textContent='Copied'; setTimeout(()=>btn.textContent='Copy',1500);}catch(e){} }
+document.getElementById('copy').onclick=e=>copyText(sn.textContent,e.target);
+document.querySelectorAll('[data-for]').forEach(b=>b.onclick=()=>copyText(document.getElementById(b.dataset.for).textContent,b));
+const DS = ["FinzData/cftc-commitments-of-traders", "FinzData/sec-13f-institutional-ownership", "FinzData/sec-insider-transactions", "FinzData/finra-short-interest", "FinzData/sec-financial-statements", "FinzData/forecast-bench", "FinzData/sec-earnings-release-dates", "FinzData/political-spending-2026", "FinzData/macro-commodities", "FinzData/macro-consumer-credit", "FinzData/macro-consumption", "FinzData/macro-consumption-international", "FinzData/macro-electricity", "FinzData/macro-financial-conditions", "FinzData/macro-fx", "FinzData/macro-growth", "FinzData/macro-housing", "FinzData/macro-income-spending", "FinzData/macro-inflation", "FinzData/macro-labor", "FinzData/macro-liquidity", "FinzData/macro-money-credit", "FinzData/macro-orders-trade", "FinzData/macro-other", "FinzData/macro-other-indicators", "FinzData/macro-population", "FinzData/macro-production", "FinzData/macro-productivity", "FinzData/macro-rates", "FinzData/macro-recession", "FinzData/macro-trade", "FinzData/macro-energy"];
+const ds=document.getElementById('ds');
+DS.forEach(id=>{const a=document.createElement('a'); a.href='https://huggingface.co/datasets/'+id; a.textContent=id.split('/')[1]; ds.appendChild(a);});
+</script>
+</body>
 </html>