港股報價

介面簡介

本介面提供港股市場指定股票的實時行情資料查詢服務。透過傳入股票程式碼（Symbol），可獲取包括最新價、漲跌額、成交量、成交額、買賣盤口（Bid/Ask）、今日高低點及52周極值等核心金融指標。資料以 JSON 格式返回，支援單次請求批次查詢多隻股票，適用於需要高頻或批次獲取港股基礎行情的業務場景。

適用場景

• 金融資訊應用：為APP或網站提供港股列表頁的實時價格重新整理功能。
• 量化交易輔助：作為策略系統的基礎資料來源，監控特定標的的價格波動與成交量變化。
• 投資組合管理：實時計算持倉市值，展示賬戶盈虧情況。
• 市場資料分析：收集歷史分時資料前的實時快照，用於分析市場情緒與資金流向。

請求與返回說明

請求方式：POST 請求引數：

• symbol (必填, String)：港股程式碼，多個程式碼使用英文逗號分隔，例如 08026,02203。

返回結果：

• code：業務狀態碼，200 表示成功。
• data：包含各股票詳情的物件集合，鍵名為股票程式碼。
• price：實時價格
• change / changeRate：漲跌額與漲跌率
• volume / value：成交量與成交額
• bid / ask：買一價與賣一價
• high / low：今日最高/最低價
• 52week_high / 52week_low：52周最高/最低價
• update_time：資料更新時間戳

接入建議

1. 批次查詢最佳化：建議將同一批次需要更新的股票程式碼合併為一個請求，以減少網路開銷和 API 呼叫次數。
2. 快取策略：港股交易時段內資料變動頻繁，非交易時段資料靜止。建議根據 update_time 判斷資料新鮮度，避免無效輪詢。
3. 異常處理：請檢查返回的 code 欄位而非僅依賴 HTTP 狀態碼。若某隻股票停牌或程式碼錯誤，對應鍵值可能為空或返回特定錯誤資訊，需做好容錯處理。
4. 時區注意：返回的時間戳通常為 Unix 時間戳，前端展示時需轉換為使用者本地時區或港股交易時區（HKT）。