Skip to content

Valuation Plate Stocks

GET /v1/quote/f10/valuation-plate-stocks

Get the constituent stock list for a plate with valuation data, supporting pagination by valuation type, sort field and direction.

Parameters

NameTypeInRequiredDescription
symbolstringqueryyesIndustry plate code, e.g. HK.LIST1003.
valuation_typeintquerynoValuation type. Default 1. 1=PE, 2=PB, 3=PS.
next_keystringquerynoPagination cursor, leave empty for first page.
limitintquerynoPage size. Default 10, max 50.
sort_typestringquerynoSort direction. Default asc. asc=ascending, desc=descending.
sort_idstringquerynoSort field. Default market_cap. Options: market_cap / valuation / forward_valuation / historical_percentile.

Request Example

bash
curl "$ip/v1/quote/f10/valuation-plate-stocks?symbol=HK.LIST1003&limit=2&valuation_type=1&sort_id=market_cap&sort_type=desc" | jq

Response Fields

FieldTypeDescription
pagination.totalintTotal number of constituent stocks in the plate.
pagination.has_moreboolWhether there is a next page.
pagination.next_keystringNext page cursor; "-1" when no next page.
stock_list[].symbolstringStock code.
stock_list[].namestringStock name.
stock_list[].valuation_valfloatValuation value (multiple).
stock_list[].forward_valuefloatForward valuation (multiple).
stock_list[].valuation_percentilefloatHistorical valuation percentile (0-100).
stock_list[].market_capfloatTotal market cap (in the symbol's market currency).

Supported Markets

  • Markets: HK / US / SH (including SZ A-shares).
  • Categories: Only industry plates supported. Concept plates, common stocks, indices etc. return no_data.
  • Limit: Max 50 records per request; use next_key for more data.

Error Codes

ret_codeerror.codeTrigger ConditionSuggested Action
0Success
-3invalid_parameterMissing symbol / invalid enum / limit out of 1-50 rangeCorrect parameters per ret_msg hint
-7invalid_symbolPlate code format valid but does not existVerify plate code
-10no_dataValid request but no constituent stock valuation dataConfirm an industry plate code is passed
-2 / -5internal_errorGateway or backend internal errorRetry later; contact support if persistent

Response Example

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "stock_list": [
      {
        "forward_value": 5.792,
        "market_cap": 1006241665662.15,
        "name": "China Ping An",
        "symbol": "HK.02318",
        "valuation_percentile": 18.8452285,
        "valuation_val": 6.691
      },
      {
        "forward_value": 5.539,
        "market_cap": 791977034100,
        "name": "China Life",
        "symbol": "HK.02628",
        "valuation_percentile": 23.5765838,
        "valuation_val": 4.83
      }
    ]
  },
  "pagination": { "has_more": true, "next_key": "2", "total": 19 }
}