1. 專案概覽
Financial-API 是 HiThink 官方的 A 股（中國大陸股票市場）金融數據服務，為 AI 代理、量化研究人員與應用程式開發者提供單一、統一的方式，查詢即時與歷史市場數據、財務報表、估值、指數、板塊及共同基金資訊，無需拼湊多個數據供應商。
2. 背景與定位
HiThink（同花順）是中國主要的金融數據與交易軟體供應商，建立此專案是為了透過對開發者友善、標準化的介面，開放其內部的市場數據基礎設施。核心使命是讓一把 API 金鑰驅動所有存取方式——REST 呼叫、供 AI 聊天工具使用的 MCP 伺服器、供腳本撰寫使用的 CLI、供研究筆記本使用的 Python SDK，以及現成的 Agent Skill——讓團隊不必為每個使用情境分別撰寫並維護不同的整合。
它與一般開放金融數據包裝器不同之處，在於其 AI 代理優先的設計：開箱即附可安裝的 Agent Skill 與原生 MCP 支援，明確避免在 LLM 工作流程中使用模擬數據與發生脈絡溢位，並專注且深入地聚焦於中國 A 股市場，而非試圖泛泛涵蓋全球交易所。
3. 功能分類
📈 市場數據——即時報價、K 線（蠟燭圖）歷史、成交量與集合競價快照。範例：最新價格查詢、盤中逐筆數據、歷史日線／分鐘線、盤前集合競價快照。
📊 財務報表與估值——用於分析與篩選的公司基本面。範例：損益表、資產負債表、現金流量表、估值比率（本益比、股價淨值比、股價營收比、股價現金流量比）。
🔥 特殊市場指標——A 股市場交易機制特有的數據。範例：漲停／跌停池、炸板追蹤、市場異常、熱門股清單、龍虎（主力交易者）排行。
🏦 指數與板塊——用於宏觀與主題分析的群組化市場觀點。範例：指數成分股、板塊表現、板塊輪動數據。
💰 共同基金與 ETF——與股票並行的基金端數據。範例：基金持股、歷史基金績效、ETF／LOF 市場報價。
🗄️ 本地數據基礎設施——用於離線、大規模分析的工具。範例：全市場數據集下載、透過 marketdb 建置本地 DuckDB 資料庫、對本地儲存的市場數據進行 SQL 查詢。
4. 重點特色
- 七種存取方式，一把 API 金鑰——Skill、MCP、REST API、CLI、Python SDK、marketdb 與直接 JSON API 皆使用相同的統一
HITHINK_FINANCE_API_KEY進行驗證。 - 原生 MCP 支援——直接連接 Claude Desktop、Cursor 與 Windsurf，讓 AI 助理以對話方式查詢金融數據。
- 可安裝的 Agent Skill——透過一條
npx skills add安裝指令，即可為程式撰寫代理提供統一介面，自動為特定請求挑選正確的後端。 - 本地 DuckDB 整合（
marketdb）——支援建置並查詢持續性的本地資料庫，適合反覆回測而不必頻繁打擊遠端 API。 - 無模擬數據政策——服務會在數據不可用時明確回報，而非捏造數值，這對研究與交易相關工作流程至關重要。
- 深度 A 股專業化——如漲停池與龍虎排行等指標，反映出對中國市場微觀結構的深入熟悉，而非泛泛的全球股票包裝器。
5. 依角色區分的使用案例
一般開發者——透過 REST API 將股票報價、財務數據或基金數據整合至網頁／行動應用程式，無需從零建置數據管線。
數據與研究科學家／量化研究人員——使用 Python SDK 與 marketdb 拉取歷史數據、建置本地 DuckDB 資料集，並直接在筆記本中執行回測或因子研究。
AI／代理建置者——安裝 Agent Skill 或設定 MCP 伺服器，讓以 LLM 為基礎的代理能使用即時數據回答金融問題或自動化研究任務。
6. 快速入門
找到你需要的內容——在文件中心瀏覽 REST API 契約與指南：
https://fuyao.aicubes.cn/docs/
安裝與整合——挑選符合你工作流程的存取方式：
# AI 代理／程式撰寫助理整合
npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes
# 命令列工具
npm install -g @hithink-tech/hithink-finance-cli
hithink-finance auth login
# Python SDK
python -m pip install -e ./python
請先至 https://fuyao.aicubes.cn/admin/ 註冊統一 API 金鑰，並將其設定為 HITHINK_FINANCE_API_KEY 環境變數。
參與貢獻——此儲存庫以 monorepo 方式組織；在 GitHub 上開啟 pull request 前，請先檢閱文件與各套件專屬的 README（hithink-finance-cli/README.md、python/README.md、skills/hithink-finance/SKILL.md）。
7. 專案結構
docs/ API 契約與中央文件中心
api/ REST API 契約來源
skills/
hithink-finance/ 可安裝的 Agent Skill（統一契約）
hithink-finance-cli/ Node.js CLI，獨立於 Python SDK
python/
marketdb/ 用於離線查詢的本地 DuckDB 介面
toolkit/fuyao/ 遠端數據客戶端與輔助腳本
examples/ 可執行的使用範例
tests/ 測試套件
examples/ 額外的靈感展示與靜態範例
scripts/ 儲存庫維護工具
8. 相關生態系
Financial-API 整合了 Model Context Protocol（MCP），使其可直接從 Claude Desktop、Cursor 與 Windsurf 使用。它透過 marketdb 模組以 DuckDB 為基礎進行本地數據儲存。底層數據平台託管於 fuyao.aicubes.cn，該站亦提供 API 金鑰管理主控台與完整文件網站。
9. 授權條款
✅ 在 MIT 授權條款下，可自由使用、複製、修改、合併、發布與散布，包括用於商業產品。
✅ 可嵌入專有或封閉原始碼應用程式。
❌ 不提供任何擔保；作者不對因使用而產生的損害負責。
ℹ️ 存取底層金融數據仍需 HiThink API 金鑰，並受 HiThink 自身的 API 服務條款約束，與程式碼本身的 MIT 授權條款分開。
ℹ️ 本服務明確不構成投資建議——輸出內容不應被視為財務建議。
10. 常見問題
問：每種整合方式（REST、CLI、MCP 等）都需要各自的 API 金鑰嗎？
答：不需要——於 https://fuyao.aicubes.cn/admin/ 取得的一把 HITHINK_FINANCE_API_KEY，即可用於全部七種存取方式。
問：建置 AI 代理時，應該使用哪種存取方式？
答：使用 Agent Skill（npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes）以獲得統一介面；若你直接在 Claude Desktop、Cursor 或 Windsurf 中作業，則可使用 MCP 伺服器。
問：我可以將數據儲存在本地，而不必每次都呼叫 API 嗎？
答：可以——使用 Python SDK 中的 marketdb 模組建置本地 DuckDB 資料庫，並對其執行 SQL 查詢。
問：此服務僅限於中國 A 股，還是涵蓋全球市場？
答：本服務專注於中國 A 股市場，包括漲停／跌停池與龍虎排行等市場特有指標。
問：若請求的數據無法取得，會發生什麼事？
答：服務會明確回報數據無法取得，而非回傳模擬或捏造的數值。
11. 快速連結
- 儲存庫：https://github.com/HiThink-Tech/Financial-API
- 文件中心：https://fuyao.aicubes.cn/docs/
- API 金鑰管理：https://fuyao.aicubes.cn/admin/
- 網站：https://fuyao.aicubes.cn/
12. 總結
Financial-API 將 HiThink 的 A 股市場數據基礎設施封裝為單一、驗證方式一致的服務，讓開發者、量化研究人員與 AI 代理都能以適合自己的格式使用——REST、CLI、Python、MCP，或隨插即用的 Agent Skill。對於正在建置中國市場金融應用程式或 AI 研究代理、需要可靠且結構良好的數據而不必拼湊多個供應商的團隊而言，此專案最具價值。