K 線形態分析
GET/api/v1.0/quote/{symbol}/kline-shape識別指定股票在日 K 或 60 分 K 下當前命中的 K 線形態、關鍵控制點座標與輔助線，若命中有效形態則自動串聯查詢該形態未來 3 天預測漲跌概率/目標區間及歷史回測勝率統計。 當標的無明顯形態時，kline_shape 返回 0（shape_name='NONE'）。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 標的代碼（路徑參數），例: US.TSLA / HK.00700 |
ktype | int | 查詢 | 否 | K 線週期：2=日 K（默認）/ 9=60 分 K |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/kline-shape?ktype=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.kline_shape | string | 命中的形態 ID（0=當前未命中任何形態） |
data.shape_name | string | 形態枚舉名稱 |
data.direction | string | 多空方向：BULLISH=看漲 / BEARISH=看跌 / NONE=無形態 |
data.shape_brief | string | 形態簡介說明 |
data.points | object | 形態關鍵控制點座標列表 |
data.points[].timestamp | integer | 控制點時間（毫秒時間戳） |
data.points[].price | number | 控制點價格 |
data.forecast | object | 未來 3 天走勢預測數據（命中形態時返回） |
data.forecast[].rise_prob | number | 未來 3 天上漲概率（百分數，原始值放大 10^9，除以 10^7 得百分數） |
data.forecast[].rise_upper_bound | number | 未來 3 天預測漲幅上限（百分數） |
data.forecast[].rise_lower_bound | number | 未來 3 天預測跌幅下限（百分數） |
data.forecast[].price_upper_bound | number | 未來 3 天預測價格上限 |
data.forecast[].price_lower_bound | number | 未來 3 天預測價格下限 |
data.forecast[].is_risk | string | 是否高風險 |
data.backtest_statistic | object | 歷史同形態回測統計數據（命中形態時返回） |
data.backtest_statistic[].total_count | integer | 歷史出現總次數 |
data.backtest_statistic[].profit_prob | number | 歷史盈利概率（百分數） |
data.backtest_statistic[].rise_upper_bound | number | 歷史平均漲幅上限（百分數） |
data.backtest_statistic[].rise_lower_bound | number | 歷史平均跌幅下限（百分數） |
data.backtest_statistic[].annual_period | integer | 回測統計年限（年） |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數缺失或不在允許範圍內 |
| -7 | invalid_symbol | 標的不存在 |
| -8 | unsupported | 市場或品類不支持 |
| -9 | permission_denied | 沒有對應權限 |
| -10 | no_data | 沒有可返回的數據 |
| -11 | rate_limited | 調用過於頻繁 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"kline_shape": "example",
"shape_name": "example",
"direction": "example",
"shape_brief": "example",
"points": "example",
"forecast": "example",
"backtest_statistic": "example"
}
}