美股/加拿大股票的分析师评级变动列表

GET /api/v1.0/quote/research/rating-change

获取美股/加拿大股票的分析师评级变动列表，可按上调/下调/首次评级筛选。 返回标的、本期与上次评级（1=Sell / 2=Hold / 3=Buy）、目标价、机构名称、建议日期。 个股一致预期请用 quote.research_analyst_consensus；个股评级汇总请用 quote.research_rating_summary。

请求参数

参数	类型	位置	必填	说明
market	string	查询	否	市场，默认 US。仅支持 US / CA
change_type	string	查询	否	变动类型，默认 UPGRADE。UPGRADE=评级上升 / DOWNGRADE=评级下降 / NEW_RATING=首次评级
page_flag	string	查询	否	翻页标记。首页不传或传空串；下一页回传上一页响应 pagination.page_flag。只有 pagination.completed 为 true 时停止
page_size	int	查询	否	返回条数，默认 10，最大 20

请求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/research/rating-change?market=US' \
  -H 'Authorization: Bearer <AccessToken>' | jq

响应参数

参数	类型	说明
data.items	object[]
data.items[].code	string	标的代码，例: US.AAPL
data.items[].name	string	标的名称
data.items[].rating	int	本期评级：1=Sell / 2=Hold / 3=Buy
data.items[].last_rating	int	上次评级：1=Sell / 2=Hold / 3=Buy
data.items[].target_price	string	本期目标价
data.items[].last_target_price	string	上次目标价
data.items[].change_type	int	变动类型：UPGRADE / DOWNGRADE / NEW_RATING
data.items[].institution_name	string	机构名称（由 institution_info_list join）
data.items[].institution_uid	string	机构 UID
data.items[].recommendation_date	string	本期建议日期，YYYY-MM-DD，时区随请求的 market
data.items[].last_recommendation_date	string	上次建议日期，YYYY-MM-DD，时区随请求的 market
pagination.total	int
pagination.completed	bool	是否已到末页。只有 true 时停止翻页
pagination.page_flag	string	下一页标记。completed 为 false 时回传为下一次请求的 page_flag；末页为空串

错误码

ret_code	error.code	说明
0	—	成功
-3	invalid_parameter	参数不合法
-8	unsupported	不支持
-10	no_data	没有数据

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "code": "US.AAPL",
        "name": "example",
        "rating": 0,
        "last_rating": 0,
        "target_price": "example",
        "last_target_price": "example",
        "change_type": 0,
        "institution_name": "example",
        "institution_uid": "example",
        "recommendation_date": "2026-10-16",
        "last_recommendation_date": "2026-10-16"
      }
    ]
  },
  "pagination": {
    "page_flag": "",
    "completed": true,
    "total": 0
  }
}