跳至主要内容

Trading API 常見問題

1. 為什麼收到 HTTP 403 錯誤（Forbidden）？​

返回 403 錯誤的原因：

  • 請求缺少認證標頭
  • 認證憑證無效
  • 帳戶權限不足

請確保請求包含所有必要標頭。詳情請參閱認證概覽。

2. 使用 Webull SDK 時需要自行處理簽名嗎？​

不需要。SDK 會自動處理簽名生成。您只需在初始化客戶端時提供 App Key 和 App Secret。

3. API 申請審批需要多長時間？​

審核和批准流程通常需要 1–2 個工作日。等待期間您可以安裝 SDK 並探索沙盒環境。詳情請參閱快速入門。

4. 支援哪些訂單類型？​

支援的訂單類型因市場而異。美股支援市價單、限價單、止損單、止損限價單、開盤/收盤市價單；港股支援增強限價盤、競價盤、競價限價盤、止損單、止損限價單、追蹤止損單、追蹤止損限價單、觸價市價單、觸價限價單等；A 股僅支援限價單。

完整的各市場訂單類型對照請參閱 Trading API 概覽 — 功能矩陣。

5. 為什麼我的訂單被拒絕？​

常見原因：

  • 購買力或保證金不足
  • 交易標的所在市場已休市
  • 訂單參數無效（如價格超出允許範圍、不支援的訂單類型）
  • Token 狀態不是 NORMAL

請查看 API 回應中的錯誤訊息了解具體原因。

6. 可以修改部分成交的訂單嗎？​

可以。使用改單端點修改價格或數量。僅未成交部分會受影響。如果訂單已完全成交或已撤銷，改單請求將被拒絕。

7. 如何接收即時訂單狀態更新？​

使用 交易事件訂閱透過 gRPC 串流接收。它會即時推送成交、撤銷、修改和失敗的更新。程式碼範例請參閱快速入門。

8. 不同市場的速率限制有差異嗎？​

有。港股和 A 股的訂單操作速率限制更嚴格：

操作美股市場港股 / A 股市場
下單 / 改單 / 撤單15 req/s1 req/s

9. A 股交易有哪些特殊要求？​

  • 僅可交易滬深港通合資格股票
  • T+1 交收 — 今日買入的股票次日才能賣出
  • 不允許賣空
  • 交易時間遵循中國大陸交易時段（09:30–11:30、13:00–15:00 CST）

10. 如何在不使用真實資金的情況下測試交易？​

使用沙盒環境（api.sandbox.webull.hk）。訂單為模擬執行，不會在真實市場成交。Token 預設為 NORMAL 狀態，無需 2FA 驗證。測試帳戶憑證請參閱 SDK 和工具。

11. 使用 Trading API 有額外費用嗎？​

透過 OpenAPI 交易不收取額外費用。交易費用與 Webull App 相同。下單前可使用預覽訂單端點預估費用。