Skip to content

Similar Candlestick Patterns ​

GET /api/v1.0/quote/{symbol}/similar-kline

Find historical K-line patterns similar to the given symbol's recent price action and get subsequent return statistics (similar_count, up_count, down_count, max_up_pct, max_down_pct, and top similar_stocks).

Request ​

ParameterTypeInRequiredDescription
symbolstringpathyesStock symbol (path param), e.g. US.TSLA / US.AAPL / HK.00700

Example ​

bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/similar-kline' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response ​

FieldTypeDescription
data.similar_countintegerTotal matched similar historical K-line samples
data.up_countintegerNumber of samples that rose subsequently
data.down_countintegerNumber of samples that fell subsequently
data.max_up_pctnumberMaximum subsequent gain among similar samples (percent)
data.max_down_pctnumberMaximum subsequent drawdown among similar samples (percent)
data.similar_stocksobjectTop similar historical stock patterns
data.similar_stocks[].codestringSimilar stock symbol
data.similar_stocks[].namestringSimilar stock name
data.similar_stocks[].similaritynumberSimilarity score (percent)

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-7invalid_symbolUnknown symbol
-8unsupportedMarket or product is not supported
-9permission_deniedMissing permission
-10no_dataNo data
-11rate_limitedToo many requests

Sample ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "similar_count": 0,
    "up_count": 0,
    "down_count": 0,
    "max_up_pct": "example",
    "max_down_pct": "example",
    "similar_stocks": "example"
  }
}