Quote

Trades Subscription

WSPush · cmd 104

Real-time trades data push of the subscribed security.

message PushTrade {
  string symbol = 1;
  int64 sequence = 2;
  repeated Trade trade = 3;
}
Quote Permission RequiredFree
  • US stocks: US LV1 included free by default (last ~1,000 ticks across pre-market, regular, after-hours, and overnight sessions).
  • HK stocks: LV1 included by default (last ~1,000 ticks).
  • US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)".

Push fields

NameTypeRequiredDescription
symbolstringOptionalSecurity code, for example: AAPL.US
sequenceint64OptionalSequence number
tradesobject[]OptionalTrades data
└ pricestringOptionalPrice
└ volumeint64OptionalVolume
└ timestampint64OptionalTime of trading
└ trade_typestringOptionalTrade type
└ directionint32OptionalTrade direction: 0 neutral, 1 down, 2 up
└ trade_sessionint32OptionalTrade session, see TradeSession

Response JSON example

{
  "symbol": "700.HK",
  "sequence": 160808750000000,
  "trade": [
    {
      "price": "158.760",
      "volume": 1,
      "timestamp": 1651103979,
      "trade_type": "I",
      "direction": 0,
      "trade_session": 2
    }
  ]
}