# Get Rating Change

get_rating_change(market, change_type=None, count=None, page=None)

  • Description

    Get rating changes, returning US stock rating change records (upgrade/downgrade/initial rating), including institution name, target price changes and other information, with pagination support.

  • Parameters

    Parameter Type Description
    market Market Market type (US only) (required)
    change_type RatingChangeType Rating change type ("UPGRADE"/"DOWNGRADE"/"NEW_RATING")
    count int Return count [1, 20], default 10
    page str Page cursor
  • Return

    Parameter Type Description
    ret RET_CODE API call result
    data pd.DataFrame When ret == RET_OK, returns data
    str When ret != RET_OK, returns error description
    • Data format:
      Field Type Description
      security str Stock code (e.g. 'US.TSLA')
      name str Stock name
      rating str Current rating ("BUY"/"HOLD"/"SELL")
      last_rating str Previous rating ("BUY"/"HOLD"/"SELL")
      target_price float Current target price
      last_target_price float Previous target price
      change_type str Rating change type ("UPGRADE"/"DOWNGRADE"/"NEW_RATING")
      institution_name str Institution name
      recommendation_date str Recommendation date (yyyy-MM-dd)
      last_recommendation_date str Previous recommendation date (yyyy-MM-dd)
      "SELL" Sell
      "HOLD" Hold
      "BUY" Buy
  • Example

from futu import *

quote_ctx = OpenQuoteContext(host='127.0.0.1', port=11111)

ret, data, next_page, all_count = quote_ctx.get_rating_change(market=Market.US, count=2)
if ret == RET_OK:
    print(f'Total count: {all_count}')
    print(data)
else:
    print('error:', data)

quote_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
  • Output
Total count: 5904
  security  name rating last_rating  target_price  last_target_price change_type institution_name recommendation_date last_recommendation_date
0    US.MU  美光科技    BUY         BUY        1500.0              950.0     UPGRADE             美银证券          2026-06-23               2026-05-13
1  US.INTC   英特尔    BUY         BUY         160.0              135.0     UPGRADE             美银证券          2026-06-23               2026-06-11
1
2
3
4

API Limits

  • Maximum 60 requests within 30 seconds
  • Only the first page of paginated requests counts toward rate limiting