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.moomoo.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
0Success
-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** ..."
    }
  }
}