Skip to content

指数成分股估值 ​

GET /api/v1.0/quote/valuation/index-stocks

获取指数成分股估值列表,支持按估值类型、排序与板块过滤分页查询。

请求参数 ​

参数类型位置必填说明
symbolstring查询是指数代码(query 参数),例: HK.800000(恒生指数) 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
valuation_typeint查询否估值类型,默认 1。1=PE / 2=PB / 3=PS / 4=ROE / 5=PEG 默认 1; 取值 1, 2, 3, 4, 5
next_keystring查询否翻页游标,首页留空,后续用上一次返回的 pagination.next_key。以 pagination.has_more=false 停止 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$
limitint查询否本次请求条数,默认 10,最大 50 ≤ 50; 默认 10
sort_typeint查询否排序方向,默认 2。1=Desc / 2=Asc 默认 2; 取值 1, 2
sort_idint查询否排序字段,默认 51。51=MarketCap / 52=Valuation / 53=ForwardValuation / 54=HistoricalPercentile 默认 51; 取值 51, 52, 53, 54
filter_securitystring查询否按板块过滤指数成分股,传板块 symbol(可由 quote.valuation_index_stock_plate_list 获取候选);不过滤时留空,例: HK.LIST1001 最长长度 32; 格式 ^$|^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$

请求示例 ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/valuation/index-stocks?symbol=HK.800000&limit=2&valuation_type=1" | jq

响应字段 ​

参数类型说明
dataobject
data.stock_listobject[]
data.stock_list[].symbolstring股票代码(含市场前缀),例: HK.00881 / HK.00968
data.stock_list[].namestring英文名
data.stock_list[].sc_namestring简体中文名,例: 中升控股 / 信义光能
data.stock_list[].tc_namestring繁体中文名
data.stock_list[].valuation_valnumber估值值,例: -10.376 / 29.509
data.stock_list[].forward_valuenumber前瞻估值,例: 8.767 / 12.876
data.stock_list[].valuation_percentilenumber历史估值分位(0-100),例: 0.8045052 / 94.4622792
data.stock_list[].market_capnumber总市值,例: 19231825136.875 / 27532601281.15
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 品类:仅支持指数。
  • 条数:单次最多 50 条,更多数据请通过 next_key 翻页。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功—
-3invalid_parameter参数非法按 ret_msg 修正
-7invalid_symbol指数代码不存在核对指数代码
-10no_data无成分股估值数据确认传入指数代码

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "stock_list": [
      {
        "forward_value": 8.767,
        "market_cap": 19231825136.875,
        "name": "Zhongsheng Group",
        "sc_name": "中升控股",
        "tc_name": "中升控股",
        "symbol": "HK.00881",
        "valuation_percentile": 0.8045052,
        "valuation_val": -10.376
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2",
    "total": 87
  }
}