# 行业分类

申万（SW2021）行业分类成分，按一/二/三级三层体系给出每只 A 股的所属行业。可用于行业归类、板块聚合、行业中性化处理及构建行业对比基准。属于参照型数据，随分类调整和成分变动而更新，并非每日变动。注意申万分类与证监会行业、概念板块口径不同，跨数据源做行业归并时需统一标准。

## 行业分类接口包含申万二级指数月收益吗？

不包含。本接口返回股票与申万行业的归属关系，不返回申万二级指数行情或月收益率。按当前行业成分构造的股票组合不等于官方行业指数，将当前成分用于历史回测还可能产生幸存者偏差。请先在[指数日线文档](https://asharehub.com/zh/docs/indices)确认支持的指数范围，取得所需指数历史序列后再计算月收益。

## 分类依据

上游分类体系参见 [Tushare 申万行业分类参考](https://tushare.pro/document/2?doc_id=181)。AShareHub 的对外请求参数与返回字段以下表为准，主证券代码统一使用 `symbol`。

`GET /v2/reference/industries`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ |

## 返回字段

| 字段 | 说明 |
| --- | --- |
| `symbol` | 股票代码 |
| `name` | 股票名称 |
| `l1_code` | 一级行业代码 |
| `l1_name` | 一级行业名称（共31个） |
| `l2_code` | 二级行业代码 |
| `l2_name` | 二级行业名称 |
| `l3_code` | 三级行业代码 |
| `l3_name` | 三级行业名称 |

## 接口示例

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/reference/industries"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.industry_list()
print(df.head())
```

## 数据样例

返回 pandas.DataFrame

| symbol | name | l1_code | l1_name | l2_code | l2_name | l3_code | l3_name |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 000001.SZ | 平安银行 | 801780.SI | 银行 | 801783.SI | 股份制银行Ⅱ | 857831.SI | 股份制银行Ⅲ |
| 000002.SZ | 万科A | 801180.SI | 房地产 | 801181.SI | 房地产开发 | 851811.SI | 住宅开发 |
| 000003.SZ | PT金田A(退市) | 801230.SI | 综合 | 801231.SI | 综合Ⅱ | 852311.SI | 综合Ⅲ |