# 股票列表

A 股全市场股票基础信息列表，每只股票一行。涵盖股票代码、名称、公司全称、所属地域与申万行业、上市状态（上市/退市/暂停）、上市日期、所属交易所，以及沪深港通标的标识。属于静态参照数据，按需更新而非每日刷新，是关联其他行情/财务数据时的主键映射表。注意默认通常只返回当前上市股票，查询退市或全量名单需显式指定上市状态。

`GET /v2/reference/stocks`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ（不填返回全部） |
| `name` | string | 否 | 股票名称 |
| `market` | string | 否 | 市场类别：主板/创业板/科创板/北交所/CDR |
| `list_status` | string | 否 | 上市状态：L上市/D退市/P暂停 |
| `exchange` | string | 否 | 交易所：SSE/SZSE/BSE |
| `is_hs` | string | 否 | 沪深港通：N否/H沪股通/S深股通 |

## 返回字段

| 字段 | 说明 |
| --- | --- |
| `symbol` | 股票代码 |
| `name` | 股票名称 |
| `area` | 地域 |
| `industry` | 行业 |
| `fullname` | 公司全称 |
| `enname` | 英文名 |
| `cnspell` | 拼音缩写 |
| `market` | 市场 |
| `exchange` | 交易所 |
| `curr_type` | 币种 |
| `list_status` | 上市状态（L=上市 D=退市 P=暂停） |
| `list_date` | 上市日期 |
| `delist_date` | 退市日期 |
| `is_hs` | 沪深港通标的（H=沪股通 S=深股通 N=否） |

## 接口示例

cURL

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

Python SDK

```
from asharehub import AShareHub

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

## 数据样例

返回 pandas.DataFrame

| symbol | name | area | industry | fullname | enname | cnspell | market | exchange | curr_type | … +4 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 000001.SZ | 平安银行 | 深圳 | 银行 | 平安银行股份有限公司 | Ping An Bank Co., L… | PAYH | 主板 | SZSE | CNY | … |
| 000002.SZ | 万科A | 深圳 | 全国地产 | 万科企业股份有限公司 | China Vanke Co.,Ltd. | WKA | 主板 | SZSE | CNY | … |
| 000004.SZ | *ST国华 | 深圳 | 软件服务 | 深圳国华网安科技股份有限公司 | Shenzhen Guohua Net… | *STGH | 主板 | SZSE | CNY | … |