行情

成交明細

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