行情

成交明细

WS请求 · cmd 17

该接口用于获取标的的成交明细数据。

message SecurityTradeRequest {
  string symbol = 1;
  int32 count = 2;
}

message SecurityTradeResponse {
  string symbol = 1;
  repeated Trade trades = 2;
}
行情权限要求免费
  • 美股:默认免费赠送 US LV1 实时行情(近 1000 笔,含盘前、盘中、盘后、夜盘全时段)。
  • 港股:默认赠送 LV1 实时行情(近 1000 笔)。
  • 美股期权:默认无权限,需购买「OPRA 美股期权行情 (OpenAPI)」行情卡,最多可获取近 1000 笔。

请求参数

名称类型必填说明
symbolstring必填标的代码,使用 ticker.region 格式,例如:700.HK
countint32必填请求的逐笔明细数量;最大 1000

响应字段

名称类型必填说明
symbolstring可选标的代码
tradesobject[]可选逐笔明细数据
└ pricestring可选价格
└ volumeint64可选成交量
└ timestampint64可选成交时间
└ trade_typestring可选交易类型说明
└ directionint32可选交易方向 (0-neutral, 1-down, 2-up)
└ trade_sessionint32可选交易时段

响应 JSON 示例

{
  "symbol": "AAPL.US",
  "trades": [
    {
      "price": "158.760",
      "volume": 1,
      "timestamp": 1651103979,
      "trade_type": "I",
      "direction": 0,
      "trade_session": 2
    }
  ]
}