所属板块
GET/v1/quote/{symbol}/owner-plate获取单个标的所属的行业 / 概念板块清单。返回每个板块的代码(含市场前缀,可作 stock 订阅 code)、板块名称和板块类型。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码(含市场前缀),例:HK.00700 / US.FUTU / SH.600036 |
请求示例
bash
curl -s "$ip/v1/quote/HK.00700/owner-plate" | jq
curl -s "$ip/v1/quote/US.FUTU/owner-plate" | jq响应字段
返回 data.sectors[],每元素一个所属板块。无所属板块的标的(指数 / 部分外盘冷门股)按空数组返回。
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 被查询标的的名称(即 symbol 对应的证券名称,并非板块名),例:富途控股 / 腾讯控股 |
plate_code | string | 板块代码(含市场前缀,可作 stock 订阅 code),例:HK.LIST1284 / US.LIST2517 |
plate_name | string | 板块名称(简体),例:热门中概股 / 资本市场 |
plate_type | string | 板块类型,详见命名词典 > plate_type |
限制范围
- 支持市场:HK / US / SH / SZ / SG / JP / AU / CA / MY / KR。
- 支持品类:正股 / ETF。指数(INDEX)、窝轮 / 牛熊 / 期权 / 期货 / 债券通常无板块,按空
sectors返回。 - 单标的查询;如需批量查询请按 symbol 多次调用。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| -3 | invalid_parameter | symbol 缺失或格式不合法(必须形如 MARKET.CODE,超 32 字符或不含 .) | 检查路径参数 symbol,例:HK.00700 |
| -7 | invalid_symbol | symbol 格式合法但后端找不到对应证券 | 通过 search 接口确认 symbol 合法性 |
| -4 | internal_error | 网关后端调用 / 响应映射失败 | 稍后重试;持续失败请反馈 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"sectors": [
{ "name": "富途控股", "plate_code": "US.LIST2517", "plate_name": "热门中概股", "plate_type": "CONCEPT" },
{ "name": "富途控股", "plate_code": "US.LIST2260", "plate_name": "资本市场", "plate_type": "INDUSTRY" },
{ "name": "富途控股", "plate_code": "US.LIST2701", "plate_name": "中东ETF", "plate_type": "OTHER" }
]
}
}