板块成分股
GET/api/v1.0/quote/plate-stock获取指定板块下的股票成员列表,支持排序与分页。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
plate_code | string | 查询 | 是 | 板块代码(来自 quote.plate_list),例: HK.LIST1045 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$ |
sort_field | string | 查询 | 否 | 排序字段,默认 NONE。详见命名词典。 默认 "NONE" |
ascend | bool | 查询 | 否 | 是否升序,默认 true。例: true=升序 / false=降序 默认 true |
price_type | string | 查询 | 否 | 价格类排序的取值口径:NORMAL=正常价 / BEFORE=盘前价 / AFTER=盘后价 / OVERNIGHT=夜盘价。默认 NORMAL 默认 "NORMAL"; 取值 NORMAL, BEFORE, AFTER, OVERNIGHT |
leverage_direction | int | 查询 | 否 | ETF 杠杆方向筛选(仅对 ETF 板块有效):0=全部 / 1=做多 / 2=做空。默认 0 ≥ 0; ≤ 2; 默认 0 |
leverage_multiple | int | 查询 | 否 | ETF 杠杆倍数筛选(仅对 ETF 板块有效),扩大 10^3,例: 2000=2 倍 / 1500=1.5 倍 / 0=全部。默认 0 ≥ 0; 默认 0 |
next_key | string | 查询 | 否 | 翻页游标(首页留空)。回传上一页 pagination.next_key;以 pagination.has_more=false 停止 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$ |
limit | int | 查询 | 否 | 每页条数,默认 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。
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.stock_list | object[] | |
data.stock_list[].code | string | 股票代码(含市场前缀),例: HK.02337 |
data.stock_list[].lot_size | int | 每手股数(期权=合约股数,期货=合约乘数),例: 1000 |
data.stock_list[].stock_name | string | 英文名 |
data.stock_list[].sc_name | string | 简体中文名 |
data.stock_list[].tc_name | string | 繁体中文名 |
data.stock_list[].stock_type | string | 证券类型,例: STOCK / ETF / WARRANT / FUTURE / DRVT 等 |
data.stock_list[].list_time | int | 上市时间,毫秒时间戳;缺数据返回 0,例: 1508083200000 |
data.stock_list[].stock_id | int | 股票 ID(数值标识),例: 74891344742689 |
pagination | object | |
pagination.total | int | |
pagination.has_more | bool | |
pagination.next_key | string |
限制范围
- 支持市场:HK / US / SH / SZ / SG / JP / CA / AU / MY / KR 等全市场(与板块列表接口返回的板块覆盖一致)。
- ETF 杠杆筛选(
leverage_direction/leverage_multiple)仅对 ETF 板块生效,其他板块即使传入也被忽略。 price_type仅影响价格类排序字段的取值口径。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功(合法板块但无成份股时 stock_list 为空数组,pagination.total=0) | — |
| -3 | invalid_parameter | 缺 plate_code / plate_code 不符合市场前缀正则 / sort_field 不在枚举内 / price_type 不在枚举内 / limit 超过 1000 / next_key 非法 | 校正请求参数后重试 |
| -7 | invalid_symbol | plate_code 解析不到合法板块(板块代码不存在或已下线) | 通过板块列表接口重新获取有效板块代码 |
| -4 | internal_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
}
}