Webull MCP Server

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

什麼是 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 申請指南

其他要求

行情訂閱（如需行情數據）：webullapp.hk/quote | 訂閱指南
uvx（需 Python 3.10+）— uv 安裝指南
支援 MCP 的 AI 客戶端 — 如 Kiro、Cursor、Claude Desktop 等

配置示範

設置步驟

第一步：安裝

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

第二步：配置 AI 客戶端

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

Kiro
Cursor
Claude Desktop

編輯 .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"
      }
    }
  }
}

編輯 .cursor/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"
      }
    }
  }
}

編輯 claude_desktop_config.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

Endpoint	Description
`get_account_list`	取得所有關聯帳戶
`get_account_balance`	取得帳戶餘額、購買力和現金詳情
`get_account_positions`	取得當前持倉和持有情況
`get_stock_tick`	取得股票逐筆成交數據
`get_stock_snapshot`	取得股票即時快照（港股、美股、A 股）
`get_stock_quotes`	取得即時買賣盤報價及深度
`get_stock_footprint`	取得股票大單足跡（資金流向）
`get_stock_bars`	批量取得股票 OHLCV K 線
`get_stock_bars_single`	取得單只股票 OHLCV K 線
`get_instruments`	取得股票標的資訊
`place_stock_order`	下股票訂單
`preview_stock_order`	預覽股票訂單（不提交）
`replace_stock_order`	修改已有股票訂單
`place_option_single_order`	下單腿期權訂單
`preview_option_order`	預覽期權訂單（不提交）
`replace_option_order`	修改已有期權訂單
`cancel_order`	取消未成交訂單
`get_order_history`	取得歷史訂單
`get_open_orders`	取得所有未成交訂單
`get_order_detail`	取得單筆訂單詳情

設定參數

變數	說明	預設值
`WEBULL_APP_KEY`	App Key（必填）	—
`WEBULL_APP_SECRET`	App Secret（必填）	—
`WEBULL_ENVIRONMENT`	`uat`（沙盒）或 `prod`（正式）	`uat`
`WEBULL_REGION_ID`	設為 `hk`	`us`
`WEBULL_TOOLSETS`	啟用的工具類別（逗號分隔）	全部啟用
`WEBULL_MAX_ORDER_NOTIONAL_USD`	美股單筆最大名義價值 (USD)	`10000`
`WEBULL_MAX_ORDER_NOTIONAL_HKD`	港股單筆最大名義價值 (HKD)	`80000`
`WEBULL_MAX_ORDER_NOTIONAL_CNH`	A 股單筆最大名義價值 (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 提供的資訊僅供參考，不構成投資建議。證券、期權及其他金融工具的交易涉及重大虧損風險。所有交易決策均由你自行判斷和承擔風險。你有責任在執行前核實訂單詳情。本軟體按「現狀」提供，不附帶任何形式的保證。

什麼是 Webull MCP​

架構概覽​

前置條件​

API 憑證（App Key 和 App Secret）​

其他要求​

配置示範​

設置步驟​

第一步：安裝​

第二步：配置 AI 客戶端​

第三步：認證​

第四步：驗證連線​

使用範例​

行情查詢​

交易​

Available Endpoints​

設定參數​

安全建議​

免責聲明​

相關連結​