Skip to content

Valuation Plate Stocks ​

GET /api/v1.0/quote/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
symbolstringqueryyesPlate symbol (query parameter), e.g. HK.LIST1003 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
valuation_typeintquerynoValuation type, default 1. 1=PE / 2=PB / 3=PS Default 1; Values 1, 2, 3
next_keystringquerynoPagination cursor; leave empty for the first page, then use pagination.next_key returned previously. Stop when pagination.has_more=false Max length 1000; Pattern ^$|^(-?[0-9]+)?$
limitintquerynoNumber of records for this request, default 10, range 1-50 ≥ 1; ≤ 50; Default 10
sort_typestringquerynoSort direction, default asc. asc / desc Default "asc"; Values asc, desc
sort_idstringquerynoSort field, default market_cap. market_cap / valuation / forward_valuation / historical_percentile Default "market_cap"; Values market_cap, valuation, forward_valuation, historical_percentile

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/valuation/plate-stocks?symbol=HK.LIST1003&limit=2&valuation_type=1&sort_id=market_cap&sort_type=desc" | jq

Response Fields ​

NameTypeDescription
dataobject
data.stock_listobject[]
data.stock_list[].symbolstringStock symbol (with market prefix), e.g. HK.02621
data.stock_list[].namestringEnglish name
data.stock_list[].sc_namestringSimplified Chinese name
data.stock_list[].tc_namestringTraditional Chinese name
data.stock_list[].valuation_valnumberValuation value (PE/PB/...); raw integer ×1e3, e.g. 0.801 / 14.225
data.stock_list[].forward_valuenumberForward valuation (only for PE/PS; the plate path may not return this; field omitted when missing)
data.stock_list[].valuation_percentilenumberHistorical valuation percentile (0-100); 0.9×1e9 represents 90%. e.g. 27.9151943 / 76.5084473
data.stock_list[].market_capnumberTotal market cap (currency based on the symbol's market); raw integer ×1e3. e.g. 703808976 / 1699196881.94
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

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
0—Success—
-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_errorService 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": "Ping An",
        "sc_name": "中国平安",
        "tc_name": "中國平安",
        "symbol": "HK.02318",
        "valuation_percentile": 18.8452285,
        "valuation_val": 6.691
      },
      {
        "forward_value": 5.539,
        "market_cap": 791977034100,
        "name": "China Life",
        "sc_name": "中国人寿",
        "tc_name": "中國人壽",
        "symbol": "HK.02628",
        "valuation_percentile": 23.5765838,
        "valuation_val": 4.83
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2",
    "total": 19
  }
}