Skip to content

板块成分股 ​

GET /api/v1.0/quote/plate-stock

获取指定板块下的股票成员列表,支持排序与分页。

请求参数 ​

参数类型位置必填说明
plate_codestring查询是板块代码(来自 quote.plate_list),例: HK.LIST1045 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
sort_fieldstring查询否排序字段,默认 NONE。详见命名词典。 默认 "NONE"
ascendbool查询否是否升序,默认 true。例: true=升序 / false=降序 默认 true
price_typestring查询否价格类排序的取值口径:NORMAL=正常价 / BEFORE=盘前价 / AFTER=盘后价 / OVERNIGHT=夜盘价。默认 NORMAL 默认 "NORMAL"; 取值 NORMAL, BEFORE, AFTER, OVERNIGHT
leverage_directionint查询否ETF 杠杆方向筛选(仅对 ETF 板块有效):0=全部 / 1=做多 / 2=做空。默认 0 ≥ 0; ≤ 2; 默认 0
leverage_multipleint查询否ETF 杠杆倍数筛选(仅对 ETF 板块有效),扩大 10^3,例: 2000=2 倍 / 1500=1.5 倍 / 0=全部。默认 0 ≥ 0; 默认 0
next_keystring查询否翻页游标(首页留空)。回传上一页 pagination.next_key;以 pagination.has_more=false 停止 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$
limitint查询否每页条数,默认 200,最大 1000 ≤ 1000; 默认 200

请求示例 ​

bash
curl 'https://webapi.futunn.com/api/v1.0/quote/plate-stock?plate_code=HK.LIST1045&limit=2' | jq

响应字段 ​

返回 data.stock_list[] 为板块成份股列表;分页信息见顶层 pagination。

参数类型说明
dataobject
data.stock_listobject[]
data.stock_list[].codestring股票代码(含市场前缀),例: HK.02337
data.stock_list[].lot_sizeint每手股数(期权=合约股数,期货=合约乘数),例: 1000
data.stock_list[].stock_namestring英文名
data.stock_list[].sc_namestring简体中文名
data.stock_list[].tc_namestring繁体中文名
data.stock_list[].stock_typestring证券类型,例: STOCK / ETF / WARRANT / FUTURE / DRVT 等
data.stock_list[].list_timeint上市时间,毫秒时间戳;缺数据返回 0,例: 1508083200000
data.stock_list[].stock_idint股票 ID(数值标识),例: 74891344742689
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 支持市场:HK / US / SH / SZ / SG / JP / CA / AU / MY / KR 等全市场(与板块列表接口返回的板块覆盖一致)。
  • ETF 杠杆筛选(leverage_direction / leverage_multiple)仅对 ETF 板块生效,其他板块即使传入也被忽略。
  • price_type 仅影响价格类排序字段的取值口径。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功(合法板块但无成份股时 stock_list 为空数组,pagination.total=0)—
-3invalid_parameter缺 plate_code / plate_code 不符合市场前缀正则 / sort_field 不在枚举内 / price_type 不在枚举内 / limit 超过 1000 / next_key 非法校正请求参数后重试
-7invalid_symbolplate_code 解析不到合法板块(板块代码不存在或已下线)通过板块列表接口重新获取有效板块代码
-4internal_error服务错误重试;持续失败请联系技术支持

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "stock_list": [
      {
        "code": "HK.02337",
        "stock_id": 74891344742689,
        "stock_name": "众诚能源",
        "stock_type": "STOCK",
        "lot_size": 1000,
        "list_time": 1508083200000
      },
      {
        "code": "HK.01193",
        "stock_id": 38976828212393,
        "stock_name": "华润燃气",
        "stock_type": "STOCK",
        "lot_size": 100,
        "list_time": 784137600000
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2",
    "total": 22
  }
}