跳至主要内容

Data API

Data API 使用 HTTP 協議進行按需行情數據查詢。適用於歷史數據檢索、快照查詢和回測。完整的可用端點列表請參閱 Market Data API 概覽。

如需透過 MQTT 獲取即時串流數據，請參閱 Data Streaming API。

基礎 URL​

環境URL
正式環境https://api.webull.hk
沙盒環境https://api.sandbox.webull.hk

請求格式​

所有 Data API 請求均為標準 HTTP GET 或 POST 呼叫。每個請求必須包含認證概覽中描述的認證標頭。

範例請求：

GET /openapi/market-data/stock/snapshot?symbols=AAPL&category=US_STOCK&extend_hour_required=false&overnight_required=false
x-app-key: <your_app_key>
x-app-secret: <your_app_secret>
x-timestamp: 2025-03-19T10:00:00Z
x-signature-algorithm: HMAC-SHA1
x-signature-version: 1.0
x-signature-nonce: <unique_nonce>
x-version: v2
x-access-token: <your_access_token>
x-signature: <computed_signature>

回應格式​

所有回應均以 JSON 格式返回。成功回應返回 HTTP 200，直接包含數據：

[
  {
    "symbol": "AAPL",
    "instrument_id": "913256135",
    "price": "185.50",
    "open": "184.00",
    "high": "186.20",
    "low": "183.80",
    "volume": "52340000",
    "change": "1.50",
    "change_ratio": "0.0082",
    "pre_close": "184.00",
    "last_trade_time": 1710849600000
  }
]

回應中的時間戳為毫秒級 Unix 時間戳。價格和數值以字串形式返回以保持精度。

標的類別​

呼叫 Data API 端點時，需要指定標的類別：

類別值說明
US_STOCK美股
HK_STOCK港股
CN_STOCKA 股（滬深港通）

速率限制​

限制值
Market Data API每分鐘 600 次請求

超過速率限制時，伺服器將返回錯誤。