行情

歷史 K 線

WS請求 · cmd 27

該接口用於獲取標的的曆史 K 線數據。

message SecurityHistoryCandlestickRequest {
  string symbol = 1;
  Period period = 2;
  AdjustType adjust_type = 3;
  HistoryCandlestickQueryType query_type = 4;
  OffsetQuery offset_request = 5;
  DateQuery date_request = 6;
}

message SecurityCandlestickResponse {
  string symbol = 1;
  repeated Candlestick candlesticks = 2;
}
行情權限要求免費
  • 按帳戶等級配額,每自然月可查詢 100–3,000 個標的(每月重置,詳見文檔中的配額表)。
  • 美股:預設免費贈送 US LV1 行情(含盤前、盤中、盤後、夜盤全時段)。
  • 港股:預設贈送 LV1 行情。
  • 美股期權:預設無權限,需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。

請求參數

名稱類型必填說明
symbolstring必填標的代碼,使用 ticker.region 格式,例如:700.HK
periodint32必填K 線週期
adjust_typeint32必填複權類型
query_typeint32必填查詢方式 (1-按偏移查詢,2-按日期區間查詢)
date_requestobject可選按日期查詢時必填
└ start_datestring可選開始日期,格式為 YYYYMMDD
└ end_datestring可選結束日期,格式為 YYYYMMDD
offset_requestobject可選按偏移查詢時必填
└ directionint32必填查詢方嚮 (0-向曆史,1-向最新)
└ datestring可選查詢日期,格式為 YYYYMMDD;為空時使用最新交易日
└ minutestring可選查詢時間,格式為 HHMM;僅在查詢分鍾級別 K 線時有效
└ countint32可選查詢數量,範圍 [1,1000];默認 10
trade_sessionint32可選交易時段,0: 盤中,100: 所有延長時段(盤前,盤中,盤後,夜盤)

響應欄位

名稱類型必填說明
symbolstring可選標的代碼,例如:AAPL.US
candlesticksobject[]可選K 線數據
└ closestring可選當前週期收盤價
└ openstring可選當前週期開盤價
└ lowstring可選當前週期最低價
└ highstring可選當前週期最高價
└ volumeint64可選當前週期成交量
└ turnoverstring可選當前週期成交額
└ timestampint64可選當前週期的時間戳
└ trade_sessionint32可選交易時段

響應 JSON 示例

{
  "symbol": "700.HK",
  "candlesticks": [
    {
      "close": "362.000",
      "open": "364.600",
      "low": "361.600",
      "high": "368.800",
      "volume": 10853604,
      "turnover": "3954556819.000",
      "timestamp": 1650384000
    }
  ]
}