Valuation Plate Stocks
GET/api/v1.0/quote/valuation/plate-stocksGet the constituent stock list for a plate with valuation data, supporting pagination by valuation type, sort field and direction.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | query | yes | Plate symbol (query parameter), e.g. HK.LIST1003 Max length 32; Pattern ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
valuation_type | int | query | no | Valuation type, default 1. 1=PE / 2=PB / 3=PS Default 1; Values 1, 2, 3 |
next_key | string | query | no | Pagination 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]+)?$ |
limit | int | query | no | Number of records for this request, default 10, range 1-50 ≥ 1; ≤ 50; Default 10 |
sort_type | string | query | no | Sort direction, default asc. asc / desc Default "asc"; Values asc, desc |
sort_id | string | query | no | Sort 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" | jqResponse Fields
| Name | Type | Description |
|---|---|---|
data | object | |
data.stock_list | object[] | |
data.stock_list[].symbol | string | Stock symbol (with market prefix), e.g. HK.02621 |
data.stock_list[].name | string | English name |
data.stock_list[].sc_name | string | Simplified Chinese name |
data.stock_list[].tc_name | string | Traditional Chinese name |
data.stock_list[].valuation_val | number | Valuation value (PE/PB/...); raw integer ×1e3, e.g. 0.801 / 14.225 |
data.stock_list[].forward_value | number | Forward valuation (only for PE/PS; the plate path may not return this; field omitted when missing) |
data.stock_list[].valuation_percentile | number | Historical valuation percentile (0-100); 0.9×1e9 represents 90%. e.g. 27.9151943 / 76.5084473 |
data.stock_list[].market_cap | number | Total market cap (currency based on the symbol's market); raw integer ×1e3. e.g. 703808976 / 1699196881.94 |
pagination | object | |
pagination.total | int | |
pagination.has_more | bool | |
pagination.next_key | string |
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_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| 0 | — | Success | — |
| -3 | invalid_parameter | Missing symbol / invalid enum / limit out of 1-50 range | Correct parameters per ret_msg hint |
| -7 | invalid_symbol | Plate code format valid but does not exist | Verify plate code |
| -10 | no_data | Valid request but no constituent stock valuation data | Confirm an industry plate code is passed |
| -2 / -5 | internal_error | Service error | Retry 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
}
}