行情

K 线

WS请求 · cmd 19

该接口用于获取标的的 K 线数据。

message SecurityCandlestickRequest {
  string symbol = 1;
  Period period = 2;
  int32 count = 3;
  AdjustType adjust_type = 4;
  int32 trade_session = 5;
}

message SecurityCandlestickResponse {
  string symbol = 1;
  repeated Candlestick candlesticks = 2;
}
行情权限要求免费
  • 按账户等级配额,每自然月可查询 100–3,000 个标的(每月重置,详见文档中的配额表)。
  • 美股:默认免费赠送 US LV1 行情(含盘前、盘中、盘后、夜盘全时段)。
  • 港股:默认赠送 LV1 行情。
  • 美股期权:默认无权限,需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。

请求参数

名称类型必填说明
symbolstring必填标的代码,使用 ticker.region 格式,例如:700.HK
periodint32必填K 线周期
countint32必填数据数量;最大 1000
adjust_typeint32必填复权类型
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
    }
  ]
}