分析師一致預期

GET /v1/quote/{symbol}/f10/analyst-consensus

獲取股票的分析師一致預期評級與目標價（綜合評級、覆蓋分析師數、各檔評級佔比、目標價區間）。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	股票代碼，如 HK.00700。

請求示例

curl "$ip/v1/quote/HK.00700/f10/analyst-consensus" | jq

響應字段

字段	類型	說明
rating	int	綜合評級。1=Sell，2=Underperform，3=Hold，4=Buy，5=Strong Buy。
total	int	覆蓋該股票的分析師總數。
strong_buy	float	強烈買入佔比（%）。
buy	float	買入佔比（%）。僅 HK/CN/SG/MY/AU/JP 返回。
hold	float	持有佔比（%）。
underperform	float	跑輸大盤佔比（%）。僅 HK/CN/SG/MY/AU/JP 返回。
sell	float	賣出佔比（%）。
average	float	平均目標價（報告幣種）。
highest	float	最高目標價。
lowest	float	最低目標價。
num_of_target_analysts	int	給出目標價預測的分析師人數。
update_time	int	評級數據更新時間，秒級時間戳。
update_time_str	string	評級數據更新日期（yyyy-MM-dd）。

限制範圍

• 市場：HK / US / CN（滬/深/北）/ SG / CA / AU / JP / MY / KR。
• 品類：正股（有分析師覆蓋）。
• 評級檔位差異：HK / CN / SG / MY / AU / JP 返回 5 檔；US / CA / KR 僅返回 3 檔（strong_buy / hold / sell）。
• 合法但無分析師覆蓋的標的返回 ret_code=0 且 data 為空對象 {}。

錯誤碼

ret_code	error.code	觸發條件	處理建議
-3	invalid_parameter	symbol 格式非法	修正股票代碼格式後重試
-7	invalid_symbol	symbol 格式合法但證券庫查不到	通過 search 接口確認代碼合法性
-2 / -4 / -6	internal_error	網關內部錯誤	稍後重試，持續失敗聯繫支持

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "average": 686.71,
    "buy": 22.727,
    "highest": 794.73,
    "hold": 0,
    "lowest": 560,
    "num_of_target_analysts": 44,
    "rating": 5,
    "sell": 0,
    "strong_buy": 77.273,
    "total": 44,
    "underperform": 0,
    "update_time": 1780729098,
    "update_time_str": "2026-06-06"
  }
}