# Industries

Shenwan (SW2021) industry classification membership, mapping each A-share to its level-1, level-2, and level-3 industry across the three-tier taxonomy. Use it for sector tagging, basket aggregation, industry-neutralization, and building peer benchmarks. This is reference data that updates only when classifications or constituents change, not daily. Note that the Shenwan scheme differs from CSRC industry codes and concept boards, so harmonize taxonomies when joining across sources.

## Does industry membership include Shenwan index monthly returns?

No. This endpoint maps stocks to Shenwan industries; it does not return a Shenwan Level-2 index price or monthly-return series. A stock basket grouped by today's industry membership is not an official index and may introduce survivorship bias in historical research. Use the [index daily reference](https://asharehub.com/en/docs/indices) to check supported index coverage, and obtain the required index history before calculating monthly returns.

## Classification reference

See [Tushare's Shenwan classification reference](https://tushare.pro/document/2?doc_id=181) for the upstream taxonomy. AShareHub's public request and response fields are defined below; primary security codes use `symbol`.

`GET /v2/reference/industries`

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | No | Stock code, e.g. 000001.SZ |

## Response Fields

| Field | Type | Description |
| --- | --- | --- |
| `symbol` | string | Stock code |
| `name` | string | Stock name |
| `l1_code` | string | L1 industry code |
| `l1_name` | string | L1 industry name (31 industries) |
| `l2_code` | string | L2 industry code |
| `l2_name` | string | L2 industry name |
| `l3_code` | string | L3 industry code |
| `l3_name` | string | L3 industry name |

## API Example

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())
```

## Sample Data

returns a 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 | 综合Ⅲ |