FTShare-Lab 查询 A 股股东人数
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询 A 股股东人数 |
| 外部接口 | /api/v1/market/data/holder/stock-holder-nums |
| 请求方式 | GET |
| 适用场景 | 指定 stock_code 查全部历史股东人数，或 is_last=true 查全市场最新一期 |
请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| stock_code | string | 否 | 单个股票代码 | 603323.SH | 不传时需配合 --is_last；支持沪深京 A 股，需 6 位数字+后缀（SH/SZ/BJ），单次仅支持一个代码 |
| is_last | flag | 否 | 取所有标的最新一期 | （flag） | 传字符串 "true"；与 stock_code 二选一 |
| page | int | 否 | 页码 | 1 | 默认 1，仅 is_last=true 模式下生效 |
| page_size | int | 否 | 每页记录数 | 50 | 默认 50 |
执行方式
通过根目录的 run.py 调用（推荐）：
python <RUN_PY> stock-holder-nums --stock_code 603323.SH
python <RUN_PY> stock-holder-nums --is_last --page 1 --page_size 50
<RUN_PY>为主SKILL.md同级的run.py绝对路径。
响应结构
{
"items": [
{
"stock_code": "000001.SZ",
"stock_name": "平安银行",
"publish_date": "2026-04-29",
"report_date": "2026-03-31",
"holder_num": 11215,
"holder_num_change_ratio": -5.5022,
"per_capita_circ_share": 4895.6833,
"per_capita_share_change_ratio": null,
"chip_concentration": null,
"close_price": "0",
"per_capita_hold_amount": "0",
"ten_holder_ratio": null,
"ften_holder_ratio": null
}
],
"total_pages": 1,
"total_items": 5784
}
顶层字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| items | Array | 否 | 股东人数列表 |
| total_pages | int | 否 | 总页数 |
| total_items | int | 否 | 总记录数 |
items 元素字段
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| stock_code | string | 否 | 股票代码 |
| stock_name | string | 否 | 股票名称 |
| publish_date | string | 否 | 发布日期 |
| report_date | string | 否 | 报告期 |
| holder_num | int | 否 | 股东人数 |
| holder_num_change_ratio | string | 是 | 股东人数较上期变化比例 |
| per_capita_circ_share | string | 是 | 人均流通股数 |
| per_capita_share_change_ratio | string | 是 | 人均流通股变化比例 |
| chip_concentration | string | 是 | 筹码集中度 |
| close_price | string | 否 | 收盘价 |
| per_capita_hold_amount | string | 否 | 人均持股金额 |
| ten_holder_ratio | string | 是 | 十大股东持股比例 |
| ften_holder_ratio | string | 是 | 十大流通股东持股比例 |
注意事项
- 必须至少指定
--stock_code或--is_last其一。 chip_concentration/ten_holder_ratio/ften_holder_ratio等字段部分标的暂为空。is_last在 query string 中传字符串"true"。