行情

價格訂閱

WS推送 · cmd 101

訂閱標的的實時價格推送,推送的數據結構中,只有有變化的字段才會填充數據。

message PushQuote {
  string symbol = 1;
  int64 sequence = 2;
  string last_done = 3;
  string open = 4;
  string high = 5;
  string low = 6;
  int64 timestamp = 7;
  int64 volume = 8;
  string turnover = 9;
  TradeStatus trade_status = 10;
  TradeSession trade_session = 11;
}
行情權限要求免費
  • 美股:預設免費贈送 US LV1 實時行情(含盤前、盤中、盤後、夜盤全時段);夜盤數據需設置 LONGBRIDGE_ENABLE_OVERNIGHT=true 開啟(詳見 Broker FAQ Q6、Q7)。
  • 港股:預設贈送 LV1 實時行情。
  • 美股期權:預設無權限,需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。

推送欄位

名稱類型必填說明
symbolstring可選標的代碼,例如:AAPL.US
sequenceint64可選序列號
last_donestring可選最新價
openstring可選開盤價
highstring可選最高價
lowstring可選最低價
timestampint64可選最新成交的時間戳
volumeint64可選成交量
turnoverstring可選成交額
trade_statusint32可選交易狀態,詳見 TradeStatus
trade_sessionint32可選交易時段,詳見 TradeSession
current_volumeint32可選兩次推送之間增加的成交量
current_turnoverstring可選兩次推送之間增加的成交額
tagint32可選價格數據標籤:0 實時行情,1 收盤後的修正數據

響應 JSON 示例

{
  "symbol": "AAPL.US",
  "sequence": 160808750000000,
  "last_done": "156.570",
  "open": "155.910",
  "high": "159.790",
  "low": "155.380",
  "timestamp": 1651089600,
  "volume": 88063191,
  "turnover": "13865092584.000",
  "trade_status": 0,
  "trade_session": 0
}