行情

历史 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
    }
  ]
}