Market Data API 概覽
Market Data API 提供對港股、美股和中國 A 股即時及歷史行情數據的存取。支援兩種存取模式：
- Data API — 基於 HTTP 的歷史和快照數據請求。適用於回測、分析和按需查詢。參閱 Data API。
- Data Streaming API — 透過 MQTT 協議（WebSocket/TCP）的即時數據推送。適用於即時交易策略和即時監控。參閱 Data Streaming API。
提示
Webull SDK 透過處理認證和協議細節來簡化整合。安裝方式請參閱 SDK 和工具。
支援的市場和產品
| 市場 | 產品 |
|---|---|
| 香港 | 股票、ETF |
| 美國 | 股票、ETF |
| 美國 | 夜盤 |
| 中國大陸 | A 股（滬港通/深港通） |
可用端點
行情數據
| 端點 | 協議 | 說明 |
|---|---|---|
| 快照 | HTTP | 即時行情快照，包含最新價、漲跌幅、成交量、換手率等。支援盤前、盤後及夜盤數據 |
| 盤口深度 | HTTP | 指定深度的最新買賣盤數據，包含價格、數量和委託明細 |
| 逐筆成交 | HTTP | 逐筆成交記錄，包含時間、價格、數量和方向。按時間倒序排列 |
| 歷史 K 線（單標的） | HTTP | 多種粒度的 OHLCV K 線數據（M1、M5、D 等）。日線及以上：前復權；分鐘線：不復權 |
| 歷史 K 線（批量） | HTTP | 多標的批量查詢。粒度和復權規則與單標的相同 |
| 足迹 | HTTP | 查詢指定股票代號、類別與時間粒度下，最新的 N 筆足跡資料記錄。 |
即時串流
| 端點 | 協議 | 說明 |
|---|---|---|
| 訂閱 | HTTP | 透過 MQTT 訂閱即時行情數據推送 |
| 取消訂閱 | HTTP | 取消即時行情數據推送訂閱 |
行情數據權限
| 市場 | 產品 | 存取方式 |
|---|---|---|
| 美國市場 | 股票、ETF、夜盤 | 請在 Webull 官網購買美股 Level 1 和/或 Level 2 行情數據 |
| 香港市場 | 股票、ETF | LV1 數據免費。如需 LV2 數據，請在 Webull 官網購買港交所 Level 2（環球版） |
| 中國大陸 | A 股（滬港通/深港通） | LV1 數據免費（中國大陸以外地區延遲 15 分鐘；中國大陸暫不支援） |
警告
透過 Webull 行動應用程式或桌面平台（QT）購買的行情數據訂閱與 OpenAPI 相互獨立。您需要單獨購買 OpenAPI 專用的數據訂閱。同一時間僅支援一台設備存取 LV1/LV2 數據。訂閱方式詳情請參閱訂閱進階行情。