Quote

Trades

WSRequest · cmd 17

This API is used to obtain the trades data of security.

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

message SecurityTradeResponse {
  string symbol = 1;
  repeated Trade trades = 2;
}
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)".

Request parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity code, in ticker.region format, e.g. 700.HK
countint32RequiredCount of trades; max 1000 per request

Response fields

NameTypeRequiredDescription
symbolstringOptionalSecurity code
tradesobject[]OptionalTrades data
└ pricestringOptionalPrice
└ volumeint64OptionalVolume
└ timestampint64OptionalTime of trading
└ trade_typestringOptionalTrade type
└ directionint32OptionalTrade direction (0-neutral, 1-down, 2-up)
└ trade_sessionint32OptionalTrade session

Response JSON example

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