歷史K線查詢

介面能力

本介面提供全球多種金融品種（包括股票、外匯、期貨、貴金屬、加密貨幣、股指等）的歷史 K 線行情資料查詢。支援從 1 分鐘到月線的多種時間週期（如 1M, 5M, 15M, 30M, 1H, 4H, D, W, M）。介面根據指定的日期和週期，返回包含時間戳、開盤價、最高價、最低價、收盤價及成交量等核心指標的 K 線資料。

請求與返回

請求時需提供品種合約程式碼（symbol）、時間週期（period）、基準日期（date）以及是否包含最新動態 K 線（withlast）。 返回結果中，Obj 欄位包含以分號分隔的 K 線資料字串，每組資料內部以逗號分隔，依次代表：時間戳、開盤價、最高價、最低價、收盤價、持倉量（部分品種）、成交量。資料排序方向為從開始時間向結束時間排列。

使用場景

• 量化交易回測：獲取歷史 K 線資料，用於編寫和驗證量化交易策略，進行歷史行情回測。
• 金融圖表繪製：為金融資訊類 App 或網站提供歷史 K 線資料來源，用於繪製 K 線圖表及技術指標分析。
• 市場資料分析：供金融研究人員或開發者進行歷史價格走勢分析、波動率計算及學術研究。

使用說明與限制

• 介面返回的資料時間跨度受週期影響：1分鐘週期最多返回近30天資料，5分鐘及小時週期最多180天，日線最多10年，周線近2年，月線近5年。
• 介面提供的資料僅供歷史行情查詢與技術分析參考，不構成任何投資建議，不得用於預測市場走勢或引導實際交易投注。
• 需注意不同品種的交易時間差異，非交易時段可能無資料返回；請根據返回的狀態碼（Code）和提示資訊（Msg）處理異常情況。