# 股东增减持

重要股东及董监高的增减持明细，逐笔给出增持(IN)或减持(DE)方向、变动股数与占总股本比例、变动后持股数量及成交均价。该数据直接反映内部人对自身公司价值的态度，是判断管理层信心与潜在筹码压力的重要依据。数据按公告日归集，存在一定披露滞后，且集中减持解禁期需结合限售股安排综合判断。

`GET /v2/market/holder-trade`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |
| `trade_type` | string | 否 | 增减持类型：IN增持/DE减持 |
| `holder_type` | string | 否 | 股东类型：C公司/P个人/G高管 |

## 返回字段

| 字段 | 说明 |
| --- | --- |
| `symbol` | 股票代码 |
| `ann_date` | 公告日期 |
| `holder_name` | 股东名称 |
| `holder_type` | 股东类型（G=高管 P=个人 C=公司） |
| `in_de` | 增减持方向（IN=增持 DE=减持） |
| `change_vol` | 变动股数 |
| `change_ratio` | 占总股本比例 |
| `after_share` | 变动后持股 |
| `after_ratio` | 变动后占比 |
| `avg_price` | 成交均价 |
| `total_share` | 公司总股本 |
| `begin_date` | 变动起始日 |
| `close_date` | 变动截止日 |

## 接口示例

cURL

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

Python SDK

```
from asharehub import AShareHub

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

## 数据样例

返回 pandas.DataFrame

| symbol | ann_date | holder_name | holder_type | in_de | change_vol | change_ratio | after_share | after_ratio | avg_price | … +3 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 000001.SZ | 20210907 | 鞠维萍 | G | IN | 30000 | 0.0002 | 30000 | 0.0002 | 17.86 | … |
| 000001.SZ | 20210907 | 陈新华 | P | IN | 50000 | 0.0003 | — | — | 17.86 | … |
| 000001.SZ | 20210907 | 邱伟 | G | IN | 50000 | 0.0003 | 50000 | 0.0003 | 17.86 | … |