# 股东户数

上市公司定期披露的股东户数数据，反映持股账户的集中或分散程度。户数持续下降通常意味着筹码趋于集中、大户或机构吸筹，是观察散户与机构博弈的结构性信号；户数快速上升则可能对应散户接盘。披露不定期，多随定期报告或公司公告发布，覆盖密度因股而异。该指标适合做趋势性观察，单期数值意义有限，需结合股价与成交配合解读。

`GET /v2/market/shareholders`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |
| `enddate` | string | 否 | 统计截止日，YYYYMMDD |
| `ann_date` | string | 否 | 公告日期，YYYYMMDD |

## 返回字段

| 字段 | 说明 |
| --- | --- |
| `symbol` | 股票代码 |
| `ann_date` | 公告日期 |
| `end_date` | 报告期末 |
| `holder_num` | 股东户数 |

## 接口示例

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/market/shareholders?symbol=000001.SZ"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.shareholders(symbol="000001.SZ")
print(df.head())
```

## 数据样例

返回 pandas.DataFrame

| symbol | ann_date | end_date | holder_num |
| --- | --- | --- | --- |
| 000001.SZ | 20260425 | 20260331 | 457610 |
| 000001.SZ | 20260321 | 20260228 | 462824 |
| 000001.SZ | 20260327 | 20260227 | 462824 |