晨星報告

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

獲取個股的晨星綜合評級報告（含星級、公允價值、護城河、不確定性、資本配置等核心評級與分析師文字解讀）。 返回包含：rating_type（1=定量/2=定性）、星級及更新時間（秒時間戳與日期串）、公允價值估值與文本、經濟護城河/不確定性/資本配置/財務健康標籤（英文）、分析師署名與報告更新時間、各維度分析文本（公允價值/護城河/不確定性/資本配置/財務健康/投資論點/基本面/估值）、分析師備註標題與正文、bull_say 與 bear_say 觀點列表、PDF 鏈接。 不同標的字段集差異由晨星數據覆蓋範圍決定，部分字段（pdf_url、*_content、bull_say/bear_say、fundamentals/valuation 文本）可能缺失；定量評級標的字段會更精簡。 分析師一致預期與目標價請用 quote.research_analyst_consensus；機構/分析師維度評級彙總請用 quote.research_rating_summary。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	股票代碼（路徑參數），例: HK.00700 / US.AAPL

請求示例

curl 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/research/morningstar' | jq

響應字段

參數	類型	說明
data.rating_type	string	評級類型，1=定量評級 / 2=定性評級（分析師覆蓋），例: 2
data.star_rating	string	晨星星級（1-5 星），例: 5
data.star_update_time	int	星級更新時間，秒級時間戳，例: 1780072800
data.star_update_time_str	string	星級更新日期字符串（市場時區 yyyy-MM-dd），例: 2026-05-30
data.fair_value	number	公允價值估值（貨幣按報告幣種），例: 800（HKD）
data.pdf_url	string	晨星報告 PDF 下載鏈接（部分標的為 null）
data.economic_moat_label	string	經濟護城河標籤（英文），取值: 'Wide' / 'Narrow' / 'None'
data.economic_moat_type	string	經濟護城河枚舉: 1=Wide / 2=Narrow / 3=None
data.uncertainty_label	string	不確定性評級標籤（英文），取值: 'Low' / 'Medium' / 'High' / 'Very High' / 'Extreme'
data.uncertainty_type	string	不確定性枚舉: 1=Low / 2=Medium / 3=High / 4=Very High / 5=Extreme
data.capital_allocation_label	string	資本配置標籤（英文），取值: 'Exemplary' / 'Standard' / 'Poor' / 'Not Rated'
data.capital_allocation_type	string	資本配置枚舉: 1=Exemplary / 2=Standard / 3=Poor / 4=Not Rated
data.financial_health_label	string	財務健康標籤（英文），取值: 'Strong' / 'Moderate' / 'Weak'（未評級時省略）
data.financial_health_type	string	財務健康枚舉: 1=Strong / 2=Moderate / 3=Weak
data.analyst_report_by_line	string	分析師署名列表，例: ['Ivan Su']
data.analyst_report_update_time	int	分析師報告更新時間，秒級時間戳，例: 1766457180
data.analyst_report_update_time_str	string	分析師報告更新日期字符串（市場時區 yyyy-MM-dd），例: 2025-12-23
data.fair_value_content	string	公允價值文本（英文），返回
data.economic_moat_content	string	經濟護城河分析文本（英文）
data.uncertainty_content	string	不確定性評級分析文本（英文）
data.capital_allocation_content	string	資本配置分析文本（英文）
data.financial_health_content	string	財務健康分析文本（英文）
data.investment_thesis_content	string	投資論點文本（英文）
data.fundamentals_content	string	基本面分析文本（多數標的不返回）
data.valuation_content	string	估值分析文本（多數標的不返回）
data.analyst_note_title	string	分析師備註標題（英文）
data.analyst_note_content	string	分析師備註正文（英文）
data.bull_say	string	看多觀點列表（英文），每項
data.bear_say	string	看空觀點列表（英文），每項
data.ai_analysis	string	晨星 AI 分析（markdown），返回 {summary 總結, analysis 解析}（部分標的不返回）

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的在證券庫中不存在
-8	unsupported	市場或品類不在本接口範圍內
-9	permission_denied	已登錄但沒有對應行情權限
-10	no_data	當前沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "rating_type": "example",
    "star_rating": "example",
    "star_update_time": 1710000000000000,
    "star_update_time_str": "example",
    "fair_value": 1.2,
    "pdf_url": "example",
    "economic_moat_label": "example",
    "economic_moat_type": "example",
    "uncertainty_label": "example",
    "uncertainty_type": "example",
    "capital_allocation_label": "example",
    "capital_allocation_type": "example",
    "financial_health_label": "example",
    "financial_health_type": "example",
    "analyst_report_by_line": "example",
    "analyst_report_update_time": 1710000000000000,
    "analyst_report_update_time_str": "example",
    "fair_value_content": "example",
    "economic_moat_content": "example",
    "uncertainty_content": "example",
    "capital_allocation_content": "example",
    "financial_health_content": "example",
    "investment_thesis_content": "example",
    "fundamentals_content": "example",
    "valuation_content": "example",
    "analyst_note_title": "example",
    "analyst_note_content": "example",
    "bull_say": "example",
    "bear_say": "example",
    "ai_analysis": "example"
  }
}