Unusual Whales 接上 Claude，期權資料用帳號登入就能查

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

2026 年 10 月 17 日晚間 9 點出頭（台北時間），Unusual Whales 官方 X 帳號貼出一段 106 秒的示範影片，開頭字幕先打出「API KEY」幾個大字，接著畫面切到 Claude 的連接器設定頁，貼上一個網址、按下 Connect、登入授權，期權資金流、暗池成交與國會交易查詢就進了對話框。這次變動的主體是入口：資料種類沒有增加，改變的是連線方式。過去要把這家美國期權資料服務接進 AI 助理，得先向它買 API 額度、申請金鑰、設定授權標頭；現在 Claude 的付費訂閱者貼一個網址、用既有的 Unusual Whales 帳號登入就能用。

我在發布兩天後實際對它的兩個連線端點各發了一次不帶憑證的請求，得到的 401 錯誤訊息長得不一樣：API 版端點回「缺少 API 權杖，請用 Bearer 格式帶上」；Claude 專用端點回「需要 OAuth 存取權杖，請先連結你的 Unusual Whales 帳號」。同一個服務、兩種拒絕方式，恰好把這次更新的重點講完了：帳號登入與 API 金鑰是兩條不同的連線路徑，入口選錯，連線失敗的原因也會不一樣。接下來把時間軸、設定方式、工具範圍、費用與資料解讀邊界逐項攤開，最後附上還沒驗證的部分。

三月就有 API 版，十月新增的是免金鑰的帳號登入

把時間軸拉長看，期權資料接 AI 這件事在 Unusual Whales 不是十月才開始。開源社群有人先做：開發者 Erik Maday 的社群版 MCP 伺服器 2026 年 1 月初就建立在 GitHub 上，至今仍持續更新，累積七十八顆星。官方版本隨後跟上：GitHub 儲存庫 2026 年 3 月 2 日建立，npm 套件 @unusualwhales/mcp 3 月 3 日發布 1.0.0 版，採 MIT 授權，README 開頭就註明靈感來自社群版。官方套件的原始碼把將近兩百個 API 指令收進二十九個分類，本機跑的是標準輸入輸出的 MCP 伺服器，部署上比 hosted 版多一步，好處是流量經過自己的機器。這條 API 路徑走的是 hosted MCP 伺服器（api.unusualwhales.com/api/mcp），金鑰從 API 管理頁申請，適合 Cursor、Codex、Perplexity 或自建的代理程式。

十月的新東西是官方 AI 應用頁上的帳號登入連接器，一次列出四條路徑，條件各不相同。開發者另外有第五條：hosted MCP 伺服器加 API 金鑰，或用 npm 套件在自己機器上跑，兩者官方都維護，差別在 hosted 版隨時是最新的，本機版要自己更新。對不想申請金鑰的人來說，重點是下面這四條：

• ChatGPT：任何方案，用 Unusual Whales 帳號登入，有小工具介面。
• Claude：Pro、Max、Team 或 Enterprise 方案，在連接器設定加入自訂連接，網址是 https://mcp.unusualwhales.com/claude，官方說桌機與手機 App 都能用。
• Grok：SuperGrok 以上方案，同樣帳號登入。
• Grok Bot：SuperGrok Heavy 或 Cursor Ultra，外加 Unusual Whales API 金鑰，官方還示範了排程任務，例如每個交易日早晨自動產生一份資金流摘要。

受影響最大的群族很明確：本來就同時付 Claude 訂閱與 Unusual Whales 資料方案的人，等於少切一個網站，固定要整理市場報告的人省下的切換與抄表時間最直接。反過來說，兩邊都沒付費的人看到的會是延遲資料（後面會講），而只用 Claude 免費版的人目前連不上這個連接器。想在 Claude 生態裡找類似前例，可以參考我們之前介紹過的 Gojiberry 客戶開發連接器，同樣是把外部服務掛進對話的玩法。

兩條連線路徑差在哪：兩種 401 說明了邊界

一般使用者走帳號登入，開發者走 API 金鑰，這兩條路在官方文件裡是分開寫的，實際打端點也真的是兩套授權。Claude 連接器這條路的設定只有三步：打開 Claude 的連接器設定（Pro 與 Max 在 Customize 選單，Team 與 Enterprise 要由組織擁有者在 Organization settings 處理）、按 Add custom connector 貼上名稱與網址、保留 Claude 自動偵測的設定後登入授權。官方頁連 OAuth client ID 都備了一份，只在 Claude 特別要求時才用得到。網址命名有個好記的規律：mcp.unusualwhales.com 開頭的子網域走帳號登入，Claude 與 Grok 各一個位址；api.unusualwhales.com 開頭的才是金鑰端點，把兩個域名想成兩棟不同的門，就不會貼錯。

Pin

兩條路的差別整理如下：

• 授權方式：帳號登入走 OAuth，瀏覽器裡點同意就完成；API 路徑要把金鑰放進 Authorization 標頭，或以 ?token= 參數掛在網址上。
• 適用對象：帳號登入照用戶端方案分流（Claude 要 Pro 以上）；API 路徑不看用戶端，看的是 Unusual Whales 的 API 方案與額度。
• 帳號權限：有網站帳號不代表有 API 額度，拿到 API 金鑰也不會反過來解鎖 Claude 訂閱，兩邊各自計價。
• 常見錯誤：官方疑難排解把兩種連不上分開列，金鑰打錯或沒生效回 401；連不上但訊息不明時，先核對網址本身，官方直接列出兩個常被搞混的網址，正是登入用子域與 API 端點這兩條路。

金鑰保管也值得提醒：API 金鑰等同一組密碼，官方文件自己寫「像對待密碼一樣對待它」，貼進公開討論串求助前先把授權欄位清掉。帳號登入這條路的授權範圍也可以自己查：Claude 端點的 OAuth 保護資源中繼資料是公開的，上面列的權限範圍只有四項，分別是辨識身分與信箱的 openid、email，加上使用工具與資源的 mcp:tools、mcp:resources，沒有交易或帳戶管理類權限。這類把金融資料接給代理的工具，資料流與授權邊界怎麼畫，我們在 同花順金融資料 API 的實測 裡也碰過同樣的問題。

一百二十八個工具能查什麼，「唯讀」的實際範圍

hosted MCP 伺服器的工具清單有公開端點，查詢當天列出一百二十八個工具，其中一百一十二個以 get_ 開頭，涵蓋期權資金流警示、暗池成交、逐月平均報酬、國會交易、內部人持股、預測市場、財報與技術指標等查詢。官方頁給的範例問法也勾勒出它設想的用法：今天 NVDA 最大的買權掃單、SPY 本週最大的暗池價位、SPX 逐履約價的 gamma 曝險、大型股下週財報與選擇權隱含的波動。有個值得記下的細節：MCP 說明頁的伺服器端快照還寫著「74 tools」，瀏覽器實際渲染出來的數字是一百二十八，同一頁出現兩種口徑，靜態內容沒有跟上清單的變化。

Pin

官方對這套工具的定位寫得很直白：每個工具都是唯讀，助理不能下單、不能建立警示、不能改帳號。這句話在交易層面是真的，工具清單裡確實沒有任何下單或帳戶設定類操作。不過把一百二十八個工具名稱逐項看過一遍，會發現十六個不以 get_ 開頭的工具裡有十一個是寫入動作：建立與更新觀察清單、建立與刪除儀表板、把市場或使用者加進或移出預測市場觀察清單，其餘五個是搜尋與查詢類。「唯讀」的精確意思是沒有交易與帳戶層級的寫入，不是每個工具都零寫入，連線之後它確實會在你自己的 Unusual Whales 帳號裡建東西。

工具清單還有一層不會寫在行銷頁的過濾機制。開源套件的原始碼顯示，部分資料目錄被標成進階等級，預設隱藏，要用環境變數明確開啟才會註冊成工具，例如外匯資料就註明要 API Advanced 或企業方案。所以就算清單上有一百二十八個名字，你登入後實際看得到多少個，取決於資料方案的等級，方案之間的差異不是價格頁上那句「部分工具需要升級」能完全說明的。

呈現形式也有差別：互動小工具只有 ChatGPT 有，官方明說 Claude 與 Grok 用文字和表格回答。示範影片裡連續三次提問把這個描述演了一遍：先問「今天最大的異常期權交易有哪些，按權利金排序」，Claude 呼叫 get_option_trades 回了一張十欄成交明細表格，欄位從 TIME、CONTRACT 到 IV、SIDE；接著說「把這些直接在聊天裡做成儀表板」，得到一張多空統計圖，標出三億兩千二百萬美元的開倉權利金與偏多、偏空的解讀分佈；最後問「帶我逐腿拆解 NDXP 十二月三十一日的結構與交易者的押注」，得到逐腿的文字分析。影片前段還展示了官方的預設問題卡，市場潮向、暗池價位、國會買了什麼、異常買權量、大戶押注各一張，每張都附 Open in Claude 按鈕，等於官方自己把「從網站發問、在 Claude 收答案」設計成固定工作流。影片右下角全程掛著 NOT FINANCIAL ADVICE 浮水印，官方自己把這條線畫在前頭。

適用範圍先看清楚：工具清單覆蓋的是美國市場，標的以美股與美股期權為主，國會交易追蹤的是美國國會議員，沒有台股或台灣期貨對應的工具。對照美東時間，台灣的早上是美國前一交易日的盤後與當日盤前，追問「今天」的資料時先把交易日講明白，答案才不會落在前一天。

免費帳號慢兩個交易日，付費才即時

帳號登入降低的是連線門檻，資料門檻還在原處。官方 AI 應用頁與定價頁的說法一致：付費方案拿到即時資料，免費帳號的期權資金流延遲兩個交易日，新聞延遲十五分鐘，警示延遲三十分鐘，部分工具需要升級。換句話說，免費帳號在 Claude 裡查到的「今天的資金流」，其實是兩個交易日前的資金流，把它當即時行情解讀就是自己踩坑。

Pin

費用是三層各自計價，2026 年 10 月 19 日查詢的數字如下：Claude 端要 Pro 以上方案；Unusual Whales 端的網站訂閱從 Retail Basic 每月 50 美元起，API 方案（資料專用、不含網站）從 API Basic 每月 150 美元起、內含 MCP 支援，商業授權的 Startup、Kafka 串流與企業方案從年繳每月 625 美元起算；API 額度多數方案有每日上限，預設每分鐘最多一百二十次請求，超過會收到 429。付費前有兩個退款相關條件值得先看：API 方案有七天免費試用，但所有銷售官方明寫不退款，只能在七天內申請換成同期別的產品。

額度的計算方式對排程用途有實際影響。API 慣例文件明寫，每日請求計數在美東時間晚上八點重設，每個回應都帶著額度上限與已用次數的標頭可以自己讀，而且只有成功的二百回應才計入額度，失敗的請求不扣；入門等級的方案改用每月計數，月繳與年繳的月度上限不同。想在 Grok Bot 或自己的代理上跑每個交易日早晨的自動摘要，先算一輪摘要會打幾個工具呼叫，再對照自己方案的每日上限，才不會月底或盤前突然斷料。超過方案回溯期的歷史資料，另有單次購買的資料商店可以補足。想在 AI 裡直接讀金融資料但不一定要期權，OpenAI 的金融業版 ChatGPT 走的是另一條把資料內建進模型服務的路線，可以對照著看。

資金流警示是規則聚合，不是大戶意圖

官方 API 文件對資金流警示的定義值得完整引用：警示是「對完整期權成交帶做的規則式聚合」。最常用的 RepeatedHits 家族指同一合約在幾毫秒內出現多筆成交，而文件自己提醒，這可能是一張訂單被拆去跟多張訂單配對，也可能是多個買賣方剛好同時進場。兩種情況在警示裡長得一樣，資料本身分不出來。同一份文件也交代了回看範圍：不帶時間條件查詢時，回傳的是截止時間前七天的警示；自建程式另有即時串流的 websocket 頻道可用，聊天連接器走的則是逐次查詢，兩種取得方式對應不同場景。

這個定義直接約束了 AI 摘要能講到什麼程度。「出現多筆符合規則的成交」是資料描述，「大戶集體進場」是對交易者身分與意圖的推論，後者需要警示以外的證據。有意思的是，官方示範影片裡輸入給 Claude 的問題正是「交易者押注了什麼」，模型會照問回答，但回答的地基仍然是規則聚合出來的成交紀錄，不是交易者的部位全貌。

API 慣例文件還給了三個實用的判讀規則。回應新鮮度看時間欄位（例如 tape_time），不要用兩次回應是否相同來判斷，底層資料沒更新時同樣的請求會回同樣的內容。HTTP 200 配空資料未必代表出錯，常見原因是該日期沒開盤、該標的不適用這個資料集，或缺少必要的篩選欄位。成交時間、申報時間與可查詢時間可能不同步，未平倉量要到隔天早上才底定。把這三條帶進對話裡追問「這筆資料的時間欄位是什麼」「用了哪個工具」，摘要才經得起核對。它把「查資料」這一步變快，投資判斷的流程省不掉。

現在要不要接：三種人三個動作

已經同時有 Claude Pro 以上與 Unusual Whales 付費方案的人，現在就能接，建議先固定一種反覆使用的查詢（例如某檔標的某個交易日的資金流警示，指定到期日與成交時間），資料時間、查詢條件與輸出格式穩定之後再考慮排程或儀表板。Team 或 Enterprise 方案的人要先問組織擁有者，連接器權限集中在組織設定，成員不一定能自己開。只有免費帳號的人也可以接，但要先把「延遲兩個交易日」貼在心上，把它當歷史資料的自然語言查詢介面，而不是行情工具。開發者與想把資料接進自己程式的人，API 路徑三月就存在，npm 套件可以本機跑；要做對外生意的人授權這關繞不過，官方慣例文件明寫個人與內部使用可以保留資料，取消訂閱後也繼續有效，但把資料再散布給別人需要另外的授權合約，把查詢結果放進公開付費報告或代客服務都在此列。

另一個值得觀察的點是文件層。Unusual Whales 為 AI 客戶端維護了一整套專用文件：skill.md 裡有抗幻覺協定，列出 AI 最常瞎掰的假端點黑名單（例如把資金流警示的正確路由 /api/option-trades/flow-alerts 寫成不存在的 /api/options/flow）、概念到路由的對照表，甚至要求每個請求帶識別用戶端的標頭；API 文件另有給代理讀的索引頁。資料服務把「AI 會查錯」當成要認真防的故障模式，這件事本身就是 2026 年資料生意形狀變化的訊號，類似的 MCP 生態目錄我們在 Awesome MCP Servers 的收錄規則實測 也看過。

還沒確認的事

我沒有付費帳號，付費方案在 Claude 裡的實際回應速度、各資料方案對一百二十八個工具的逐項可用性，以及示範影片裡那種多空統計圖在一般查詢中出現的頻率，都屬於未驗證。X 貼文的觀看與互動數字會隨時間變動，這裡不引用。連接器設定欄位與方案條件可能變動，官方頁面的工具數字也證實會落後於實際清單，價格與工具數都是 2026 年 10 月 19 日的查詢結果，方案異動或連接器改版時需要回查；免費延遲的幅度若跟著方案調整，這篇的延遲結論也要重算。