Quote

Candlesticks

WSRequest · cmd 19

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

message SecurityCandlestickRequest {
  string symbol = 1;
  Period period = 2;
  int32 count = 3;
  AdjustType adjust_type = 4;
  int32 trade_session = 5;
}

message SecurityCandlestickResponse {
  string symbol = 1;
  repeated Candlestick candlesticks = 2;
}
Quote Permission RequiredFree
  • Quota-based access: 100–3,000 unique symbols per calendar month depending on account tier (resets monthly; see quota table in the docs).
  • US stocks: US LV1 included free by default (pre-market, regular, after-hours, and overnight sessions).
  • HK stocks: LV1 included by default.
  • 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
periodint32RequiredCandlestick period
countint32RequiredCount of candlestick; max 1000
adjust_typeint32RequiredAdjustment type
trade_sessionint32OptionalTrading session, 0: intraday, 100: All (pre, intraday, post, overnight)

Response fields

NameTypeRequiredDescription
symbolstringOptionalSecurity code, e.g. AAPL.US
candlesticksobject[]OptionalCandlestick data
└ closestringOptionalClose price
└ openstringOptionalOpen price
└ lowstringOptionalLow price
└ highstringOptionalHigh price
└ volumeint64OptionalVolume
└ turnoverstringOptionalTurnover
└ timestampint64OptionalTimestamp
└ trade_sessionint32OptionalTrade session

Response JSON example

{
  "symbol": "700.HK",
  "candlesticks": [
    {
      "close": "362.000",
      "open": "364.600",
      "low": "361.600",
      "high": "368.800",
      "volume": 10853604,
      "turnover": "3954556819.000",
      "timestamp": 1650384000
    }
  ]
}