跳至主要内容

Webull MCP Server

Webull MCP Server 讓 AI 助手（Kiro、Cursor、Claude Desktop 等）透過 Model Context Protocol (MCP) 安全存取 Webull OpenAPI 的交易和行情數據能力。

原始碼：webull-inc/webull-mcp-servers

什麼是 Webull MCP​

Webull MCP Server 是一個基於 Model Context Protocol 的伺服端，將 Webull OpenAPI 的能力封裝為 AI 助手可呼叫的工具（Tools）。透過 MCP，你可以在 AI 程式助手中直接用自然語言完成：

  • 查詢即時行情（港股、美股、A 股）
  • 查看帳戶餘額和持倉
  • 下單、改單、撤單（股票、期權）
  • 查詢歷史訂單和訂單詳情

HK 區域支援港股、美股和 A 股市場，自動適配區域特有的訂單類型（增強限價盤、競價盤、競價限價盤等）、交易時段和驗證規則。

架構概覽​

前置條件​

API 憑證（App Key 和 App Secret）​

根據你的帳戶類型申請：

個人用戶：Trading API 申請指南

機構用戶：Broker API 申請指南

其他要求​

配置示範​

設置步驟​

第一步：安裝​

確認已安裝 Python 3.10+ 和 uvx。無需手動安裝 Webull MCP Server，AI 客戶端會透過 uvx 自動下載並啟動。

第二步：配置 AI 客戶端​

在你的 AI 客戶端的 MCP 設定檔中添加以下配置，將 your_app_key 和 your_app_secret 替換為你在前置條件中取得的憑證：

編輯 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "webull": {
      "command": "uvx",
      "args": ["webull-openapi-mcp", "serve"],
      "env": {
        "WEBULL_APP_KEY": "your_app_key",
        "WEBULL_APP_SECRET": "your_app_secret",
        "WEBULL_REGION_ID": "hk",
        "WEBULL_ENVIRONMENT": "prod"
      }
    }
  }
}
提示

沙盒環境請將 WEBULL_ENVIRONMENT 設為 uat。

第三步：認證​

首次使用前需要在終端機中完成一次認證：

uvx webull-openapi-mcp auth

認證流程如下：

在 Webull App 中批准認證請求後，Token 會自動儲存至本地。Token 有效期 15 天，使用時自動刷新。

第四步：驗證連線​

重新啟動你的 AI 客戶端，在對話中嘗試：

取得我的帳戶列表

如果返回了你的帳戶資訊，表示 Webull MCP 已成功連線。

使用範例​

行情查詢​

取得 00700 的即時行情快照
取得 AAPL 最近 5 天的日 K 線

交易​

以市價買入 100 股騰訊 (00700)
以市價買入 10 股 AAPL

Available Endpoints​

EndpointDescription
add_watchlist_instruments新增股票至自選清單。
cancel_order取消未成交訂單（股票、期權、期貨、加密貨幣、事件合約）。
create_watchlist建立新的自選清單。
delete_watchlist刪除自選清單及其所有股票（不可復原）。
get_52_week_high_low取得52週高低點股票排行榜。
get_account_balance取得帳戶餘額（淨資產、購買力、現金、市值、損益）。
get_account_list取得所有關聯帳戶。
get_account_positions取得帳戶持倉清單。
get_analyst_rating取得證券分析師評級（強力買入／買入／持有／賣出數量）。
get_analyst_target_price取得分析師對證券的目標價共識。
get_balance_sheet取得股票各期間的資產負債表。
get_cash_flow取得股票各期間的現金流量表。
get_company_profile取得公司簡介（業務描述、行業、執行長、員工人數等）。
get_crypto_bars取得加密貨幣OHLCV K線資料。
get_crypto_instruments取得加密貨幣商品資訊。
get_crypto_snapshot取得加密貨幣即時快照。
get_event_bars取得事件合約OHLCV K線資料。
get_event_categories取得事件合約分類清單。
get_event_depth取得事件合約委託簿深度。
get_event_events取得系列內的事件清單。
get_event_instruments依系列取得事件合約商品。
get_event_series取得事件合約系列（週期性事件範本）。
get_event_snapshot取得事件合約即時快照。
get_event_tick取得事件合約逐筆成交資料。
get_financial_alert取得財務預警（下次報告預估值與去年同期比較）。
get_financial_indicators取得股票關鍵財務指標／比率。
get_fund_allocation取得基金各日期的資產配置。
get_fund_brief取得基金簡介資訊。
get_fund_dividends取得基金配息歷史紀錄。
get_fund_files取得基金文件／說明書。
get_fund_holdings取得基金前十大持倉。
get_fund_net_value取得基金淨值（NAV）歷史資料。
get_fund_performance取得基金各時間區間的報酬率。
get_fund_rating取得基金評級歷史紀錄。
get_fund_splits取得基金拆分歷史紀錄。
get_futures_bars批次取得期貨OHLCV K線資料。
get_futures_depth取得期貨委託簿深度。
get_futures_footprint取得期貨大單足跡（委託流向）。
get_futures_instruments取得期貨商品資訊。
get_futures_product_class取得所有期貨產品分類群組。
get_futures_products取得所有期貨產品及產品代碼。
get_futures_snapshot取得期貨即時快照。
get_futures_tick取得期貨逐筆成交資料。
get_gainers_losers取得依漲跌幅排名的漲幅榜／跌幅榜。
get_high_dividend取得高股息股票排行榜。
get_income_statement取得股票各期間的損益表。
get_instruments取得股票／ETF商品資訊。
get_market_sectors取得市場板塊概覽排名。
get_market_sectors_detail取得特定市場板塊的股票清單及統計資料。
get_most_active取得最活躍股票排行榜。
get_open_orders取得所有當前未成交訂單。
get_order_detail取得單筆訂單詳情。
get_order_history取得歷史訂單（預設最近7天）。
get_stock_bars批次取得股票OHLCV K線資料（支援多標的）。
get_stock_bars_single取得單一股票的OHLCV K線資料。
get_stock_capital_flow取得股票各日期的資金流向分佈。
get_stock_dividend_calendar取得股票配息行事曆。
get_stock_earnings_calendar取得股票財報行事曆。
get_stock_filings取得美股SEC申報文件（近3年）。
get_stock_forecast_eps取得股票預測EPS。
get_stock_footprint取得股票大單足跡（委託流向）。
get_stock_industry_comparison取得股票同業比較（最多20家同業）。
get_stock_noii_bars取得股票NOII K線資料（開盤／收盤競價失衡）。
get_stock_noii_snapshot取得股票在競價階段的最新NOII快照。
get_stock_quotes取得股票即時買賣報價（含委託簿深度）。
get_stock_snapshot取得股票／ETF即時快照（支援多標的）。
get_stock_tick取得股票逐筆成交資料。
get_watchlist_instruments取得自選清單中的所有股票。
get_watchlists取得當前使用者的所有自選清單。
place_algo_order下算法訂單（TWAP、VWAP、POV）。
place_crypto_order下加密貨幣訂單。
place_event_order下事件合約訂單。
place_futures_order下期貨訂單。
place_option_single_order下單腿期權訂單。
place_option_strategy_order下多腿期權策略訂單。
place_stock_combo_order下組合股票訂單（OTO／OCO／OTOCO）。
place_stock_order下股票訂單（單一，非組合）。
preview_option_order預覽期權訂單（不提交）。
preview_stock_order預覽股票訂單（不提交）。
remove_watchlist_instruments從自選清單移除股票。
replace_event_order修改已有事件合約訂單。
replace_futures_order修改已有期貨訂單。
replace_option_order修改已有期權訂單。
replace_stock_order修改已有股票訂單。
update_watchlist更新自選清單的名稱或排序。
update_watchlist_instruments更新自選清單中股票的排列順序。

設定參數​

變數說明預設值
WEBULL_APP_KEYApp Key（必填）—
WEBULL_APP_SECRETApp Secret（必填）—
WEBULL_ENVIRONMENTuat（沙盒）或 prod（正式）uat
WEBULL_REGION_ID設為 hkus
WEBULL_TOOLSETS啟用的工具類別（逗號分隔）全部啟用
WEBULL_MAX_ORDER_NOTIONAL_USD美股單筆最大名義價值 (USD)10000
WEBULL_MAX_ORDER_NOTIONAL_HKD港股單筆最大名義價值 (HKD)80000
WEBULL_MAX_ORDER_NOTIONAL_CNHA 股單筆最大名義價值 (CNH)70000
WEBULL_MAX_ORDER_QUANTITY單筆最大下單數量1000
WEBULL_SYMBOL_WHITELIST允許交易的標的白名單（逗號分隔）無限制

如果只需要唯讀存取（行情+帳戶），可設定 WEBULL_TOOLSETS=account,market-data 停用交易工具。

安全建議​

  • 不要將你的 App Key、App Secret 或 Token 透過聊天輸入給大模型。 這些憑證應僅透過 mcp.json 的 env 欄位傳遞給 MCP Server 程序，而非作為對話內容發送。
  • 下單前使用 preview_stock_order / preview_option_order 預覽訂單。
  • 使用 WEBULL_SYMBOL_WHITELIST 限制可交易標的。

免責聲明​

Webull MCP Server 提供的資訊僅供參考，不構成投資建議。證券、期權及其他金融工具的交易涉及重大虧損風險。所有交易決策均由你自行判斷和承擔風險。你有責任在執行前核實訂單詳情。本軟體按「現狀」提供，不附帶任何形式的保證。

相關連結​