# 股权股东信息

> 获取股权股东信息

## 接口基本信息

- **接口名称**: `get_stock_equity_shareholder`
- **功能描述**: 查询 A 股股本及股东数据（36 项指标），含总股本、流通/限售情况、前十大股东等
- **数据更新频率**: 季度更新
- **请求方法**: `POST`
- **API 路径**: `https://api.wanxingai.com/openapi/get_stock_equity_shareholder/`

---

## 输入参数说明

| 参数名 | 类型 | 必选 | 描述 | 示例 |
| --- | --- | --- | --- | --- |
| `stock_code` | str | **是** | 完整股票代码，需带交易所后缀，多个用英文逗号分隔 | `600519.SH` |

---

### 返回数据说明

返回 JSON 数组，格式为 `[{code, latest_report_period, data: [{indicator, description, value}]}]`

| 字段名 | 类型 | 描述 |
| --- | --- | --- |
| `code` | str | 标准股票代码 |
| `latest_report_period` | str | 最新报告期，格式 YYYYMMDD |
| `data` | array[object] | 指标数组，每项含 indicator、description、value |

---

### 完整指标列表（共 36 项）

| 分类 | indicator | description |
| --- | --- | --- |
| 股本结构 | `total_shares_stock` | 总股本 |
| `total_shares_before_listed_stock` | 上市前总股本 |
| `total_ashare_stock` | A股合计 |
| `float_ashare_stock` | 流通A股 |
| `limited_ashare_stock` | 限售A股 |
| 其他股本 | `total_bshare_stock` | B股合计 |
| `free_float_shares_stock` | 自由流通股 |
| `total_float_shares_stock` | 流通股合计 |
| `total_limited_shares_stock` | 限售股合计 |
| `depository_receipt_ratio_stock` | 预托证券对应标的股票的比例 |
| `float_ashare_exright_stock` | 流通A股（除权） |
| 第一大股东 | `holder_name_stock` | 第一大股东名称 |
| `holder_held_num_stock` | 第一大股东持股数量 |
| `holder_held_ratio_stock` | 第一大股东持股比例（%） |
| `holder_held_shares_nature_stock` | 股东持股股份性质 |
| 前十大股东 | `top10_hlolder_held_num_stock` | 前十大股东持股数量合计 |
| `top10_hlolder_held_ratio_stock` | 前十大股东持股比例合计（%） |
| `org_holder_name_stock` | 前十大机构股东名称（逗号分隔） |
| 前十大流通股东 | `float_holder_name_stock` | 前十大流通股东名称（逗号分隔） |
| `float_holder_held_ratio_stock` | 第一大流通股东持股比例（%） |
| `top10_float_hlolder_held_ratio_stock` | 前十大流通股东持股比例合计（%） |
| 股东性质 | `holder_nature_stock` | 股东性质 |
| `org_holder_type_stock` | 机构股东类型 |
| `float_holder_held_share_nature_stock` | 流通股东持股股份性质 |
| 流通股东持股市值 | `float_holder_held_mv_stock` | 流通股东持股市值 |
| 限售股 | `holder_held_ls_num_stock` | 大股东持有的限售股份数 |

（其余指标：`float_bshare_stock` 流通B股、`limited_bshare_stock` 限售B股、`neeq_ashare_stock` 股转系统A股、`neeq_bshare_stock` 股转系统B股、`neeq_sum_stock` 股转系统合计、`hk_listed_stock_stock` 香港上市股、`overseas_listed_shares_stock` 海外上市股、`float_holder_held_num_stock` 第一大流通股东持股数量、`top10_float_hlolder_held_num_stock` 前十大流通股东持股数量合计、`unfloat_shares_before_reform_stock` 股改前非流通股）

---

## 使用示例

```python
import requests

url = "https://api.wanxingai.com/openapi/get_stock_equity_shareholder/"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-********"
}
payload = {
    "stock_code": "600519.SH"
}

resp = requests.post(url, json=payload, headers=headers)
print(resp.json())
```

```java
import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
String json = "{
     "stock_code": "600519.SH"
}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.wanxingai.com/openapi/get_stock_equity_shareholder/"))
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer sk-********")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

```curl
curl -X POST https://api.wanxingai.com/openapi/get_stock_equity_shareholder/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-********" \
  -d '{"stock_code": "600519.SH"}'
```

### 注意事项

1. 返回数据对应最新报告期（通过 `latest_report_period` 字段获取）