同花順金融資料 API 實測：把 A 股行情與財報餵給 AI Agent

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

GitHub 上那個打著同花順官方旗號的 Financial-API，是真的官方。這是本篇最想先講完的一件事：金融資料接口最怕遇到假官方站，而這個專案單看 GitHub 長得實在不像大公司做的，帳號是 2026 年 6 月 9 日才開的、沒有簡介、只有一個倉庫。但把憑證、套件發布者與官網連結分別查過一輪之後，可以確認它就是同花順（Hithink）自己的產品，倉庫採 MIT 授權，目前約兩千一百顆星。

確認完身分，才輪到真正影響你決策的部分。這套服務把 A 股行情、財報、估值與公募基金資料包成 REST API、MCP、命令列工具與 Python SDK，設計上明顯是給 AI Agent 用的。我實際從 npm 裝了它的命令列工具、打過它的鑑權邊界、翻完官方文檔與 GitHub issue；沒有申請同花順帳號與 API Key，所以拿到金鑰之後的資料品質，本文不替它背書。

幾個藏在檯面下的事實先講：整份文檔沒有定價頁、沒有免費額度說明；官方不公布限流數字；從台灣直連它的伺服器，同一條網路五次測試裡有兩次直接逾時。它是值得認識的資料來源，串接前該驗的帳也要算清楚。

先驗官方身分：憑證、套件發布者與雙向連結

它的官網掛在 fuyao.aicubes.cn，這個域名本身看不出任何來歷，真正的硬證據在 TLS 憑證上。用 curl 檢視交握過程，這個站台出示的憑證是簽給 *.10jqka.com.cn 的萬用憑證，主體欄位寫著 Hithink RoyalFlush Information Network Co.,Ltd.（浙江杭州），走 DigiCert 的信任鏈、驗證通過。10jqka.com.cn 是同花順的主網域，敢在別的域名上掛主網域萬用憑證，基本上等於母公司出面作保。

另一條線在 npm。官方套件 @hithink-tech/hithink-finance-cli 的發布者信箱掛在 myhexin.com 網域下，那是同花順的企業網域，免費信箱註冊不到這種地址。雙向連結則補上最後一塊：官網首頁的「開源社區」選單直接連回 GitHub 與 Gitee 上的 HiThink-Tech/Financial-API，倉庫的 README 也連回官網，站上靜態資源還載自同花順自家的 thsi.cn CDN。幾條線指向同一個結論。

順帶一提它的開發節奏，因為這會影響你怎麼看活躍度：倉庫的提交史以「快照」式的大量同步為主，2026 年 8 月 27 日一天就進了四個快照提交，貢獻者清單只有官方帳號一個。這是企業內部開發之後定期對外發布鏡像的模式，看它活不活躍要看快照節奏與 issue 回覆，單看 commit 數或貢獻者人數會得到錯誤結論。變更日誌顯示它從 6 月的本地資料庫工具，一路長到 7 月的基金與估值能力、8 月的集合競證與特色資料，三個月內能力的擴張速度相當快。

第一個使用者是 AI Agent：文檔裡到處都是對模型說的話

打開它的官網原始碼，你會看到一段直接寫給爬取這個頁面的大模型看的提示，叫 ChatGPT、Claude、Cursor 優先去讀兩份純文字聚合檔 llms.txt 與 llms-full.txt，後者一次打包全站文檔與完整的接口契約。它的目標讀者從一開始就包含模型本身，這在金融資料服務裡很少見。

沿著這條線看下去，整套產品都是同一個思路。倉庫裡有 AGENTS.md 規範代理器的行為；一行 npx skills add HiThink-Tech/Financial-API 能把整套使用說明裝進 Claude Code 這類支援 Skill 的工具；首頁的整合對象清單列的是 Codex、Claude Code、QClaw、WorkBuddy、OpenClaw，一般投資人反而不在這份名單上。如果你的工作流程裡也有讓代理器呼叫外部工具的環節，像 BrowserWing 這類把操作變成代理器指令的瀏覽器自動化工具一樣，它把自己包裝成代理器生態的一部分，而不是另一個要人肉爬表格的網站。

Pin

最值得細看的是那份 Skill 文件的行為條款。它規定代理器不得把金鑰寫進程式碼、對話或日誌；全市場等級的大結果必須寫成本地檔案、只在對話裡回報路徑與摘要；真實資料不可用時要明確說原因，不得拿靜態示例或模擬資料冒充；分析輸出要標註資料來源與「非投資建議」。一家金融資料商把反捏造條款直接寫進產品文檔，這個訊號比任何功能表都誠實地說明了它預期的使用場景：讓模型自動跑金融資料流程，而且它很清楚模型會在哪裡出錯。

走 MCP 路線的人要看它的接線方式：託管端點拆成四個服務，A 股行情與特色資料、指數與板塊、標的檢索等基礎資訊、基金各自一個，全部用同一組金鑰放在請求頭鑑權。文檔也明說了定位：MCP 工具是 REST 能力的代理器適配層，兩邊共享同一套後端，資料語義一致，差別只在呼叫形態。實際串接時有個已知的粗糙處：issue #40 回報它的 MCP 服務在 prompts/list 回應的型別規格與嚴格客戶端預期不符，會導致部分工具同步不到工具清單，官方已回覆處理中。你的 MCP 客戶端如果特別挑規格，先在小環境驗過再上正式流程。

Pin

回應格式也是同樣的設計哲學。所有業務回應、包括錯誤，全部包在 HTTP 200 裡，用信封裡的 code 欄位分發結果；欄位統一 snake_case、時間戳用毫秒級、幣別顯式標註。文檔自己寫明了理由：減少模型解析歧義。代價是你的監控與重試邏輯不能依賴 HTTP 狀態碼，要解開信封看 code。

無金鑰實測：目錄看得到、錯誤契約清楚、但文檔對不上

它的命令列工具可以完全不申請帳號就先盤點能力。從 npm 安裝 hithink-finance-cli，11 個相依套件、4 秒裝完，執行 capabilities 會輸出完整的能力目錄：69 項，其中遠端能力 56 項、本地資料庫操作 13 項。分布很說明產品重心：基金類佔 28 項是最大一塊，同花順特色的漲跌停池、熱榜、龍虎榜等共 11 項，行情與財報反而是相對小的板塊。

不帶金鑰直接打行情快照端點，伺服器回 HTTP 200，信封內容是 {"code":2003,"message":"Missing X-api-key"}。給一個捏造的金鑰，回的也是 2003，訊息換成 Invalid or revoked API key。命令列端的錯誤處理更完整，會回結構化的 AUTH_API_KEY_MISSING，附上取得金鑰的網址與下一步指令。錯誤路徑有被認真設計過，這點值得肯定。

問題是文檔跟實際行為對不上。文檔的錯誤碼表明明白白定義 2001 是「未認證、金鑰缺失或無效」、2003 是「權限不足」，快速上手的疑難排解也教你看 2001；但實際服務對缺金鑰與無效金鑰都回 2003。照文檔寫的判斷式去分類錯誤會直接判錯，除錯時要看 message 欄位，不能只看 code。而且這個區域確實有惱人的坑：issue #33 有使用者剛建完金鑰就收到 2003，官方回覆說官網建的金鑰不需要另外申請權限、正確格式是 sk-fuyao 開頭、失效就刪掉重建；另一個 issue #45 則是 Windows 環境下金鑰狀態顯示已設定、直接打 REST 仍回 2003，開了一週多沒有回覆。你串接後的第一件工作，應該是用一檔標的把金鑰的完整來回驗一遍。

從台灣直連，五次裡成功三次

它解析到的伺服器位址在中國行動通訊的網路上。我在同一條海外網路連續打了五次行情端點，三次拿到正常回應，兩次在 15 秒處逾時；用無頭瀏覽器載首頁，也碰過 40 秒載不完要重試的情況。這不是每次都失敗的牆，是時通時斷的品質問題，對一次性查詢影響不大，對排程任務與生產環境就是必須處理的變數。

實務上的意義：重試與逾時要當成預設行為寫進你的接線，串接前先花幾天在自己的網路環境抽測可達率；如果你的代理器要即時回應使用者，考慮加上快取層。想長期監測 API 回應行為，可以參考 LLM API Test 從瀏覽器實測 API 速度的做法，把量測這件事從感覺變成數字。

「不限量」的承諾，沒有價格頁也沒有 QPS 數字

README 寫這個專案不設累計呼叫次數上限，但服務會視情況動態限流。實際數字是多少？沒有。issue #37 有使用者直接問約定的 QPS 是多少，說自己不小心撞到了 429，官方回覆沒有給出任何具體數字，只建議觸發限流後降低頻率再重試。「不限量」在這裡的準確意思是：不數你的總量，但速率上限由服務端單方面決定且隨時可調。

錢的事更模糊。整份站上文檔沒有定價頁，沒有免費額度說明，也沒有商用授權條款；README 只說資料權限與可用能力以官網與帳號授權為準。現在申請金鑰不要錢，未來要不要錢、以什麼方式收，完全沒有承諾。個人研究可以現在用，要接進商業產品的人，這筆帳需要先跟官方問清楚。

資料從哪來也被人問過。issue #50 的標題就是資料來源授權詢證，提問者後來撤回了問題，並在正文註明專案已調整資料來源方案、現階段優先採用免費公開管道。這是提問者自己的陳述，官方沒有補充任何說明。對資料授權鏈有嚴格要求的人要知道：這個問題目前沒有官方答案，你拿到的是「同花順品牌 + 未說明的資料來源」的組合。

能力邊界：A 股日 K 與公募基金撐起主要盤面，分鐘線缺席

具體講它有什麼、沒什麼。歷史 K 線一次只能查一檔標的、時間範圍最長十年、只有日線層級（官網總覽頁宣稱支援日、週、月線，端點契約卻明載目前僅支援日線，這也是文檔對不上的另一處）；命令列能力目錄裡標成十年級時間範圍的有五項、五年級的兩項（都在基金類）、還有三項是當日限定，過了今天就查不到，集合競價快照與當日個股異動清單都在此列。財報有三張報表多期序列加五類財務指標，估值快照固定回市盈率（TTM 與 MRQ 兩種口徑）、市淨率、市銷率、市現率。公募基金是產品裡最厚的一塊，從基金資料、經理人、持有人結構到 ETF 與 LOF 的場內行情都拆成獨立接口。

明確不在範圍裡的：分鐘 K 線、逐筆成交、港美股行情、宏觀經濟資料、新聞公告與研報原文。要做日內策略或海外市場的人，這裡直接出局。它也沒有交易功能，issue #48 有人問能不能下單查持倉，這不在產品定位裡。

大量資料的路徑設計是對的：marketdb 用 DuckDB 在本機建庫，全市場十年日 K、近十個交易日日 K 與全歷史復權因子走 Parquet 檔案下載，不逐檔拉接口，下載按鈕回的是短時效的 S3 預簽名連結，不能當長期位址快取；本地庫支援增量同步、校驗修復與 SQL 查詢，視圖直接建好前復權日線。復權資訊的給法也值得注意：事件流回傳的是現金分紅、送股、配股的原始事件，前復權與後復權要呼叫端自己推導，預計算結果才走另一個帶 adjust 參數的接口。把原始資料跟加工結果分開給，研究型使用者可以自己選口徑，這是老派但可信賴的做法。這條路對回測型使用者比反覆呼叫遠端接口健康得多，搭配 Data-Analysis-Agent 用自然語言查資料庫的思路，或 QuantDinger 那類自架回測工作台，可以組成一條從資料落地到研究產出的流程。

同花順特色資料要驗了再用。issue #55 是我查證當天新開的：有使用者批次查了 185 個日期的歷史熱榜，每一天回的都是同一份 30 檔名單，跟另一個排名走勢接口的結果對不上，官方尚未回覆。熱榜、異動原因、龍虎榜這些是它相對獨家的盤面資料，也是近月擴充的能力，依賴之前先抽驗幾個日期。

誰該接、誰先繞路

該接的人：你的代理器或研究流程需要穩定、結構化的 A 股行情與財報資料來源，能接受中國境內節點的連線品質，也願意自己處理重試。順序建議是先裝命令列工具跑 capabilities 盤點、確認你要的資料都在目錄裡，再申請金鑰驗一檔標的的完整來回，最後才把正式流程接上去。

先繞路的人：要分鐘級以下資料的、要港美股的、要現成選股訊號的。它從頭到尾都是資料層，沒有任何投資建議功能，本文也不對任何標的做判斷；把資料接口當投顧用，方向從第一天就錯了。商用需要白紙黑字授權合約的團隊，在官方補上條款之前也先觀望。

從台灣申請的人還會撞上第一道牆：申請金鑰要用同花順帳號登入官網，帳號註冊需不需要中國手機號，我沒有實際走完註冊流程，無法替你確認，這一步留給你實測。

整體看下來，把它當「Agent 世代的官方資料接口」對待，它的設計誠意是真的，從錯誤信封到反捏造條款都看得出來；把它當「免費無限量金融資料來源」對待，你很快就會撞上沒有價格頁、沒有 QPS 數字、海外連線時好時壞這三道真實存在的牆。資料來源沒有聖杯，只有把邊界算清楚的工程。