跳至主要内容

Webull Agent Skills

Webull Agent Skills 讓 AI 編碼助手（Cursor、Claude Desktop、Copilot、Kiro 等）能夠透過本地 Python 腳本安全地存取 Webull OpenAPI 的交易和行情數據能力，支援多環境（生產/沙盒）路由，適用於香港、美股及 A 股市場。

原始碼：webull-inc/webull-agent-skills

什麼是 Webull Agent Skills​

Webull Agent Skills 是一組獨立的 Python 腳本，基於官方 Webull Python SDK 構建。任何能執行 shell 命令的 AI 編碼助手都可以直接呼叫。透過自然語言，你可以：

  • 查詢即時行情數據（港股、美股、A 股）
  • 查看帳戶餘額和持倉
  • 下單、改單、撤單（股票、ETF、期權）
  • 查詢訂單歷史和訂單詳情
  • 透過 2FA Token 流程進行認證

架構概覽​

前置條件​

API 憑證​

根據你的帳戶類型申請：

個人用戶：交易 API 申請指南

機構用戶：經紀商 API 申請指南

其他要求​

配置示範​

配置步驟​

第 1 步：安裝依賴​

pip install webull-openapi-python-sdk

第 2 步：配置憑證​

在專案根目錄建立 .env 檔案，填入你的憑證：

WEBULL_APP_KEY=your_app_key
WEBULL_APP_SECRET=your_app_secret
WEBULL_ENVIRONMENT=prod
WEBULL_REGION_ID=hk

第 3 步：認證​

首次使用前，需要完成一次性 2FA 認證：

python3 scripts/cli.py auth

認證流程：

在 Webull App 中批准 2FA 請求後，Token 會快取在本地，使用時自動刷新。

第 4 步：驗證連線​

python3 scripts/cli.py trading --action account-list

如果返回了帳戶資訊，說明配置成功。

在不同 AI 工具中整合​

將腳本放在 .kiro/skills/ 目錄下，Kiro 會自動載入 SKILL.md 並識別所有可用操作。直接用自然語言對話即可：

查看 00700 最新價格

使用範例​

直接用自然語言與 AI 助手對話即可：

行情數據：

查看 00700 最新價格
顯示 AAPL 最近 5 天的日 K 線
取得 09988 的即時報價

交易操作：

顯示我的帳戶列表
查看帳戶餘額
以增強限價 350 買入 100 股 00700
撤銷 AAPL 的未成交訂單
查看我的未成交訂單
查看歷史訂單

帳戶：

我目前的持倉是什麼？

可用端點​

端點說明
stock_snapshot取得即時股票快照（港股、美股、A 股）
stock_bars取得單隻股票 OHLCV K 線數據
stock_batch_bars批量取得多隻股票 K 線數據
stock_tick取得股票逐筆成交數據
stock_quotes取得即時買賣盤口報價（深度行情）
stock_footprint取得大單足跡（資金流向）
get_instruments取得股票/ETF 標的資訊
get_account_list取得所有關聯帳戶
get_account_balance取得帳戶餘額、購買力、現金詳情
get_account_positions取得當前持倉
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查看訂單詳情

配置​

透過 .env 檔案或環境變數。必填：

WEBULL_APP_KEY=<your_app_key>
WEBULL_APP_SECRET=<your_app_secret>

可選：

變數預設值說明
WEBULL_ENVIRONMENTuatuat（沙盒）或 prod（生產）
WEBULL_REGION_IDusHK 地區設為 hk
WEBULL_MAX_ORDER_NOTIONAL_USD10000最大訂單金額（USD）
WEBULL_MAX_ORDER_QUANTITY1000每筆最大股數
WEBULL_SYMBOL_WHITELIST（無）允許交易的標的白名單（逗號分隔）
WEBULL_TOKEN_DIRconf/Token 儲存目錄
WEBULL_AUDIT_LOG_FILE（stderr）審計日誌檔案路徑
WEBULL_LOG_LEVELWARNINGSDK 日誌等級

環境端點​

環境HTTP API交易事件 (gRPC)行情流 (MQTT)
生產api.webull.hkevents-api.webull.hkdata-api.webull.hk
沙盒api.sandbox.webull.hkevents-api.sandbox.webull.hkdata-api.sandbox.webull.hk

輸出格式​

所有操作直接輸出格式化文字到 stdout，並附帶地區感知的免責聲明：

⚠️ Disclaimer: The information provided by this tool is for reference only ...

=== Stock Snapshot: 00700 ===
  Symbol:          00700
  Price:           350.20
  Pre Close:       348.60
  Change:          1.60
  ...
  • 成功：免責聲明 + 格式化數據到 stdout，退出碼 0
  • 錯誤：錯誤訊息到 stderr，退出碼 1
  • HK 地區：英文 + 簡體中文 + 繁體中文免責聲明

安全建議​

  • 不要在聊天中直接分享 App Key、App Secret 或 Token，憑證僅透過 .env 檔案或環境變數傳遞
  • 下單前使用 preview 預覽訂單
  • 使用 WEBULL_SYMBOL_WHITELIST 限制可交易標的
  • 使用 WEBULL_MAX_ORDER_NOTIONAL_USD 和 WEBULL_MAX_ORDER_QUANTITY 限制訂單規模
  • 使用 local-check 在不發送請求的情況下驗證訂單參數

故障排查​

錯誤訊息原因解決方案
Insufficient permission / subscribe to stock quotes數據權限不足訂閱行情數據
HTTP Status: 401 / UNAUTHORIZED憑證/環境不匹配檢查 .env 配置
HTTP Status: 417 / INVALID_TOKENToken 過期或快取問題重新執行 python3 scripts/cli.py auth
Failed to resolve / NameResolutionErrorDNS/網路問題檢查網路/代理/防火牆設定

免責聲明​

本工具提供的資訊僅供參考，不構成投資建議。證券、期權及其他金融工具的交易涉及重大損失風險。所有交易決策由您自行決定並承擔風險。您有責任在執行前驗證訂單詳情。本軟體按「原樣」提供，不附帶任何形式的保證。

相關連結​