Skip to main content
GET
Candlestick Data

Plan Access

Notes

  • The Free plan can query candlesticks but cannot specify a time range with start_time or end_time.
  • The last candlestick in the result may still be forming; its price and volume may continue to change.
  • Suitable for technical indicator calculations. For stock-data archiving or strategy backtesting, record the query time and adjustment mode; if you store unadjusted candlesticks, use Adjustment Factors to generate adjusted prices as needed. Historical adjusted prices may change after corporate actions or data updates.
  • To get the latest candlestick for multiple symbols in one request, use Latest Candlesticks.
  • A-shares, HK stocks, and US stocks consistently support unadjusted, forward-adjusted, and backward-adjusted prices

Supported Markets

Candlestick Intervals

Lowercase m in 1m means minutes, while uppercase M in 1M means months.

Request Parameters

Response Fields

Authorizations

X-API-Key
string
header
required

Query Parameters

symbol
string
default:700.HK
required

Trading symbol code

Example:

"700.HK"

interval
enum<string>
default:1h
required

K-line period, options: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M

Available options:
1m,
3m,
5m,
15m,
30m,
1h,
2h,
4h,
1d,
1w,
1M
Example:

"1h"

limit
integer

Number of records; defaults to 100. Values above 1000 are capped at 1000, and non-positive values use the default of 100

Example:

100

start_time
integer

Start timestamp (milliseconds)

Example:

1703123456789

end_time
integer

End timestamp (milliseconds)

Example:

1703209856789

type
enum<string>

Symbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated. Values: stock, indices, crypto, forex, futures

Available options:
stock,
indices,
crypto,
forex,
futures
Example:

"stock"

adjust
enum<string>
default:none

Price adjustment for A-shares, HK stocks, and US stocks: none (unadjusted), forward, or backward. If omitted, prices are unadjusted (none)

Available options:
none,
forward,
backward
Example:

"forward"

Response

200 - application/json

Successful response.

code
integer
Example:

0

message
string
Example:

"success"

data
object