跳至主要内容

Market Data API 常見問題

1. 為什麼我收到 HTTP 403 錯誤(Forbidden)?​

返回 403 錯誤的原因:

  • 請求缺少認證標頭
  • 認證憑證無效
  • 您的帳戶沒有足夠的權限存取請求的數據

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

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

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

3. 如何獲取行情數據權限?Webull App 的訂閱是否有效?​

透過 Webull 行動應用程式或桌面平台(QT)購買的訂閱與 OpenAPI 相互獨立。您需要單獨購買 OpenAPI 專用的訂閱。詳細步驟請參閱訂閱進階報價。

4. Market Data API 的速率限制是什麼?​

Data API(HTTP)的速率限制為每分鐘 600 次請求。Data Streaming API(MQTT)的訂閱/取消訂閱操作沒有速率限制。更多詳情請參閱 Market Data API 概覽。

5. 為什麼我的 MQTT 連接斷開了?​

常見原因:

  • 您在多個連接中使用了相同的 session_id — 新連接會替換前一個連接
  • 您超過了每個 App Key 最多 5 個並發連接的限制(錯誤碼 105)
  • 心跳超時 — 伺服器未及時收到回應

請參閱 Data Streaming API 了解連接規則和錯誤碼。

6. 為什麼重新連接後收不到數據?​

MQTT 訂閱在斷開連接後不會自動恢復。重新連接後必須再次呼叫 Subscribe API 以恢復數據串流。

7. 為什麼 MQTT 訊息是二進位格式?​

串流負載使用 Protocol Buffers 序列化,而非 JSON。您需要使用 Data Streaming API 文件中提供的 proto 定義進行解析。唯一的例外是 notice 主題,它使用 JSON。

8. 可以同時從多台設備存取 LV1/LV2 數據嗎?​

不可以。每個訂閱同一時間僅支援一台設備存取 Level 1 和 Level 2 行情數據。