Skip to content

Valuation Detail

GET /api/v1.0/quote/{symbol}/valuation/detail

Get valuation metrics (PE/PB/PS) and historical trend for a stock or index. Stocks return full valuation (trend + market distribution + plate distribution + profit growth rate); indices return trend + constituent valuation distribution.

Parameters

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700 (stock) or HK.800700 (index).
valuation_typeintquerynoValuation type. Default 1. 1=PE, 2=PB, 3=PS.
interval_typeintquerynoTime span. Default 3. 1=3 months, 2=6 months, 3=1 year, 4=3 years, 5=Since May 2019, 6=5 years, 7=10 years, 8=2 years, 9=20 years, 10=30 years.

Request Example

bash
curl "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/valuation/detail?valuation_type=1&interval_type=3" | jq

Response Fields

FieldTypeApplicableDescription
valuation_typeintStock+IndexValuation type, same as input parameter.
last_update_timeintStock+IndexLast data update time, second-level timestamp.
last_update_time_strstringStock+IndexUpdate time string.
trendobjectStock+IndexValuation trend. Contains current_value (current valuation), average_value (interval average), avg_minus_1_stddev / avg_plus_1_stddev (+/-1 standard deviation), valuation_percentile (historical percentile 0-100), historical_items[]. Stocks also contain forward_value (forward value).
market_distributionobjectStock+IndexValuation distribution. Stocks contain sections, total, ranking, average_value, median_value; indices only contain sections, total.
plate_distributionobjectStock onlySector/plate distribution. Includes plate, plate_name (English), plate_sc_name, plate_tc_name, plate_average_value, plate_ranking, stock_items[] (each with symbol, name, sc_name, tc_name, value, market_cap).
profit_growth_rateobjectStock onlyProfit growth rate. Contains financial_ttm_multiple, market_cap_multiple, year_count, conclusion_detailed, profit_data[].

Supported Markets

  • Markets: HK / US / SH / SZ / BJ / SG / JP / AU / CA.
  • Categories: Common stocks (full valuation), indices (trend + constituent distribution). ETF / Warrants / Options / Futures / Forex etc. not supported.
  • Valid symbols without valuation coverage return zero values/empty structures.

Error Codes

ret_codeerror.codeTrigger ConditionSuggested Action
-3invalid_parameterInvalid symbol format / valuation_type not in [1,2,3] / interval_type not in [1..10]Correct parameters and retry
-7invalid_symbolSymbol format valid but not found in security databaseVerify code validity via search API
-2 / -4 / -6internal_errorGateway internal errorRetry later, contact support if persistent

Response Example

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "valuation_type": 1,
    "last_update_time": 1780733886,
    "last_update_time_str": "2026-06-06 16:18:06",
    "trend": {
      "current_value": 17.12,
      "average_value": 23.097,
      "avg_minus_1_stddev": 9.8,
      "avg_plus_1_stddev": 36.395,
      "forward_value": 169.802,
      "valuation_percentile": 8.51,
      "historical_items": [
        { "value": 21.964, "time": 1749398400, "time_str": "2025-06-09", "plate_value": 22.046 }
      ]
    },
    "market_distribution": {
      "sections": [{ "start": 0, "end": 5, "number": 194 }],
      "total": 1516,
      "ranking": 908,
      "average_value": 11.877,
      "median_value": 13.208
    },
    "plate_distribution": {
      "plate": "HK.LIST23617",
      "plate_name": "Power Generation Equipment",
      "plate_sc_name": "发电设备",
      "plate_tc_name": "發電設備",
      "plate_average_value": 17.199,
      "plate_ranking": 7,
      "plate_stock_item_count": 22,
      "stock_items": [
        { "symbol": "HK.02590", "name": "Geek+", "sc_name": "极智嘉-W", "tc_name": "極智嘉-W", "value": -2120, "market_cap": 25515435921.84 }
      ]
    },
    "profit_growth_rate": {
      "financial_ttm_multiple": 1.148,
      "market_cap_multiple": 0.788,
      "year_count": 5,
      "conclusion_detailed": "5-year net income growth slightly outpaced market cap..."
    }
  }
}