HiThink-Tech/Financial-API

HiThink‑Tech / Financial‑API – 同花順金融數據服務

是什麼 – 由中國市場數據供應商同花順（10 Juqka）維護的商用級資料平台。針對AI代理、量化研究人員與開發者，提供統一、API金鑰保護的A股（中國主機板）市場資料服務。

核心功能

• 任意A股代碼的即時快照、集合競價快照與日K線（OHLCV）。
• 全公司財務報表（損益、資產負債表、現金流量表）及一系列估值比率（PE、PB、PS、PCF）。
• 元資料：代碼查詢、交易日曆、公司行為、拆股/送股因子以及前向/後向調整價格。
• 市場級資料：指數/產業成分股、基金/經理人資訊、公開期貨與期權合約，以及限漲/跌池、"炸板"（突破）池、熱門股與龍虎榜排名等特殊清單。
• 用於回測或因子研究的大規模市場資料導出。
• 基於本地DuckDB的marketdb，可增量同步整個市場，並支援使用一般SQL進行查詢。

存取方式

方法	典型使用情境	入口點
REST API	嵌入Web服務、應用程式，任何語言	https://fuyao.aicubes.cn/api/...（README中的curl範例）
MCP（Model‑Center‑Protocol）	接入Claude Desktop、Cursor、Windsurf等LLM工具	六個主機端點（A股、A股指數、元資料、基金、期貨、期權）
CLI (@hithink-tech/hithink-finance-cli)	快速終端查詢、批量下載、資料轉儲、本地DuckDB初始化	hithink-finance … 命令
Python SDK (python/ 套件)	記事本探索、自訂腳本、與pandas/NumPy整合	python -m pip install -e ./python 後使用 toolkit/fuyao 腳本
Agent Skill (skills/hithink-finance/)	讓AI代理自動選擇最佳後端（API、MCP、CLI、SDK）	透過 npx skills add … 安裝

典型工作流程

1. 從網頁儀表板取得單一API金鑰並安全儲存（HITHINK_FINANCE_API_KEY）。
2. 選擇最方便的入口點（技能 → 代理，CLI用於臨時查詢，SDK用於筆記本，REST用於服務）。
3. 將代碼解析為唯一的 thscode（例如 600519.SH）。
4. 呼叫所需端點（快照、K線、財務資料等）。
5. 對於大結果，系統將檔案本地寫入（DuckDB或CSV），僅返回路徑/摘要給呼叫者。

適合誰使用

• AI代理（如Claude、Cursor等）：需要即時市場資料的場景——安裝技能，使代理能自動在API、MCP或CLI間切換。
• 量化研究人員：建構回測、因子模型或儀表板——使用CLI或marketdb保持本地DuckDB副本，並用SQL查詢。
• 開發者：建構交易導向的Web或行動應用程式——直接呼叫REST API，支援任意語言。
• 資料工程師：需要批量市場資料用於資料湖攝取。

安全與合規注意事項

• API金鑰絕不能硬編碼或提交至原始碼管理。
• 大型結果集必須寫入磁碟；服務不會流式傳輸大型JSON負載，以避免上下文溢出。
• 本服務不提供投資建議——呼叫者必須將任何分析標記為「非建議」。
• 限速為軟性限制（無硬性配額），但建議避免突發性高併發流量。

專案狀態

• 活躍維護的單體倉儲（Python + Node.js CLI + 技能）。
• 最近版本增加了集合競價資料、擴展了基金覆蓋範圍，並引入了統一技能。
• 未來路線圖提及將與即將推出的同花順AI客戶端整合，以實現更緊密的LLM工作流程。

授權 – MIT。

---

以上所有資訊均直接來自倉儲的README；未推斷任何額外功能。