板块列表
GET/api/v1.0/quote/plate-list获取指定市场指定板块分类下的所有板块列表。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
market | string | 查询 | 是 | 市场前缀。详见命名词典。 |
plate_class | string | 查询 | 是 | 板块分类:ALL / INDUSTRY / REGION / CONCEPT / OTHER。详见命名词典。 |
请求示例
bash
curl 'https://webapi.futunn.com/api/v1.0/quote/plate-list?market=HK&plate_class=INDUSTRY' | jq响应字段
返回 data.plate_list[],每元素一个板块:
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.plate_list | object[] | |
data.plate_list[].code | string | 板块代码(含市场前缀,可作 stock 订阅 code 使用),例: HK.LIST1284 |
data.plate_list[].plate_name | string | 板块英文名 |
data.plate_list[].sc_name | string | 板块简体中文名,例: 中医药 / 公共运输 |
data.plate_list[].tc_name | string | 板块繁体中文名 |
data.plate_list[].plate_id | string | 板块 ID(不含市场前缀),例: LIST1284 |
pagination | object | 部分接口返回分页信息 |
限制范围
- 市场:详见命名词典(10 个市场)。
- 板块分类:
REGION仅 SH / SZ 支持,其他市场传入返回unsupported。 - 无数据时按空
plate_list返回。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | 缺 market 或 plate_class;取值不在枚举内(区分大小写) | 校正参数后重试 |
| -8 | unsupported | plate_class=REGION 但 market 不是 SH / SZ | 改用 SH / SZ;其他市场暂无地域板块 |
| -5 | internal_error | 服务错误 | 重试 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"plate_list": [
{
"code": "HK.LIST23618",
"plate_id": "LIST23618",
"plate_name": "光学媒体"
},
{
"code": "HK.LIST1062",
"plate_id": "LIST1062",
"plate_name": "个人护理"
}
]
}
}