Skip to content

Morningstar Report ​

GET /api/v1.0/quote/{symbol}/research/morningstar

Get the Morningstar comprehensive rating report for a stock, including star rating, fair value, economic moat, uncertainty, capital allocation, financial health and other core ratings, as well as analyst text commentary for each dimension.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700.

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/research/morningstar" | jq

Response Fields ​

FieldTypeDescription
rating_typeintRating type. 1=Quantitative, 2=Qualitative (analyst-covered).
star_ratingintMorningstar star rating, 1-5.
star_update_timeintStar rating update time, second-level timestamp.
star_update_time_strstringStar rating update date (yyyy-MM-dd).
fair_valuenumberFair value estimate (report currency).
economic_moat_labelstringEconomic moat label: Wide / Narrow / None.
economic_moat_typeintEconomic moat enum. 1=Wide, 2=Narrow, 3=None.
uncertainty_labelstringUncertainty label: Low / Medium / High / Very High / Extreme.
uncertainty_typeintUncertainty enum. 1=Low, 2=Medium, 3=High, 4=Very High, 5=Extreme.
capital_allocation_labelstringCapital allocation label: Exemplary / Standard / Poor / Not Rated.
capital_allocation_typeintCapital allocation enum. 1=Exemplary, 2=Standard, 3=Poor, 4=Not Rated.
financial_health_labelstringFinancial health label: Strong / Moderate / Weak.
financial_health_typeintFinancial health enum. 1=Strong, 2=Moderate, 3=Weak.
analyst_report_by_linearray<string>Analyst byline.
analyst_report_update_timeintAnalyst report update time, second-level timestamp.
analyst_report_update_time_strstringAnalyst report update date.
fair_value_contentobjectFair value analysis text, contains context, update_time, update_time_str.
economic_moat_contentobjectEconomic moat analysis text.
uncertainty_contentobjectUncertainty analysis text.
capital_allocation_contentobjectCapital allocation analysis text.
financial_health_contentobjectFinancial health analysis text.
bull_sayarray<object>Bull case list.
bear_sayarray<object>Bear case list.
ai_analysisobjectMorningstar AI analysis, contains summary and analysis.

Supported Markets ​

  • Category: Only common stocks have Morningstar ratings. ETF / Index / Options / Futures / Forex etc. return no_data.
  • Markets: Coverage is per-stock; markets with rating data include HK / US / SH / SZ / AU / CA.
  • Stocks not covered by Morningstar also return no_data.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success—
-3invalid_parameterSymbol missing or invalid formatCorrect code format and retry
-7invalid_symbolCode format valid but security not foundVerify code exists
-10no_dataSymbol valid but no Morningstar rating coverageNo Morningstar report for this symbol, no need to retry
-2 / -4 / -6internal_errorGateway internal errorRetry; report if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "rating_type": 2,
    "star_rating": 5,
    "star_update_time": 1780677360,
    "star_update_time_str": "2026-06-06",
    "fair_value": 800,
    "economic_moat_label": "Wide",
    "economic_moat_type": 1,
    "uncertainty_label": "High",
    "uncertainty_type": 3,
    "capital_allocation_label": "Exemplary",
    "capital_allocation_type": 1,
    "analyst_report_by_line": ["Ivan Su"],
    "analyst_report_update_time": 1766457180,
    "analyst_report_update_time_str": "2025-12-23",
    "economic_moat_content": {
      "context": "...",
      "update_time": 1766457180,
      "update_time_str": "2025-12-23"
    },
    "analyst_note_title": {
      "context": "Tencent: From AI Laggard to AI Landlord of the WeChat Ecosystem...",
      "update_time": 1780399942,
      "update_time_str": "2026-06-02"
    },
    "bull_say": [
      { "context": "Several Tencent products remain early in their monetization cycles...", "update_time": 1766457180, "update_time_str": "2025-12-23" }
    ],
    "ai_analysis": {
      "summary": "Morningstar believes that Tencent's current share price is undervalued...",
      "analysis": "**1. Valuation & Rating** ..."
    }
  }
}