分析師一致預期
GET/api/v1.0/quote/{symbol}/research/analyst-consensus獲取股票的分析師一致預期及目標價。 返回包含：綜合評級 rating（1-5，5=Strong Buy）、覆蓋分析師總數 total、各檔評級比例（強烈買入/買入/持有/跑輸大盤/賣出，單位 %）、平均/最高/最低目標價（按報告幣種）、數據更新時間（秒時間戳與日期串）。 僅返回彙總數據，不含逐條機構/分析師評級。 逐機構/分析師評級清單請用 quote.research_rating_summary；晨星評級報告請用 quote.research_morningstar_report。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 股票代碼（路徑參數），例: HK.00700 / US.AAPL |
請求示例
bash
curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/research/analyst-consensus' | jq響應字段
| 參數 | 類型 | 說明 |
|---|---|---|
data.rating | int | 綜合評級（1-5，5=強烈買入），例: 5 |
data.total | int | 覆蓋該股票的分析師總數，例: 44 |
data.strong_buy | number | 強烈買入比例（%），例: 77.273 |
data.buy | number | 買入比例（%），例: 22.727 |
data.hold | number | 持有比例（%），例: 0 |
data.underperform | number | 跑輸大盤比例（%），例: 0 |
data.sell | number | 賣出比例（%），例: 0 |
data.average | number | 平均目標價（按報告幣種），例: 686.71 |
data.highest | number | 最高目標價，例: 794.73 |
data.lowest | number | 最低目標價，例: 560 |
data.num_of_target_analysts | int | 給出目標價預測的分析師人數（區別於 total 評級人數；無目標價數據時缺省），例: 38 |
data.update_time | int | 評級數據更新時間，秒級時間戳，例: 1780194341 |
data.update_time_str | string | 評級數據更新日期字符串（按市場時區），格式 yyyy-MM-dd，例: 2026-05-31 |
錯誤碼
| 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": {
"rating": 0,
"total": 0,
"strong_buy": 1.2,
"buy": 1.2,
"hold": 1.2,
"underperform": 1.2,
"sell": 1.2,
"average": 1.2,
"highest": 1.2,
"lowest": 1.2,
"num_of_target_analysts": 1710000000000000,
"update_time": 1710000000000000,
"update_time_str": "example"
}
}