FTShare-Lab 查询 A 股十大流通股东
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询 A 股十大流通股东 |
| 外部接口 | /api/v1/market/data/holder/stock-holder-ften |
| 请求方式 | 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 调用（推荐）：
# 查询 603323.SH 所有公告期十大流通股东
python <RUN_PY> stock-holder-ften --stock_code 603323.SH
# 查询全市场最新一期（分页）
python <RUN_PY> stock-holder-ften --is_last --page 1 --page_size 50
<RUN_PY>为主SKILL.md同级的run.py绝对路径。
响应结构
{
"items": [
{
"stock_code": "603323.SH",
"stock_name": "苏农银行",
"publish_date": "2026-03-31",
"share_holding": 23.15,
"fen_holders": [
{
"rank": 1,
"shareholder_name": "香港中央结算有限公司",
"shareholder_type": "境外法人",
"share_type": "A股",
"shareholding": 55000000.0,
"share_ratio": 3.90,
"limit_num": null,
"unlimit_num": null,
"change_shares": 1200000.0,
"change_type": "增持",
"change_percentage": 2.23
}
]
}
],
"total_pages": 1,
"total_items": 21
}
顶层字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| items | Array | 否 | 公告期列表（每个元素对应一个公告期） |
| total_pages | int | 否 | 总页数 |
| total_items | int | 否 | 总记录数 |
fen_holders 数组元素字段
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| rank | int | 否 | 股东名次 |
| shareholder_name | String | 否 | 股东名称 |
| shareholder_type | String | 否 | 股东性质 |
| share_type | String | 否 | 股份类型，固定为"A股" |
| shareholding | string | 否 | 持股数（股） |
| share_ratio | string | 否 | 占股本持股比例（%） |
| limit_num | string | 是 | 流通限售数量 |
| unlimit_num | string | 是 | 流通无限售数量 |
| change_shares | string | 否 | 增减（股） |
| change_type | String | 是 | 变动类型 |
| change_percentage | string | 是 | 变动比例（%） |
注意事项
- 必须至少指定
--stock_code或--is_last其一，否则报错。 - 指定
--stock_code时返回该标的全部历史，通常total_pages为 1。 --is_last模式按page/page_size分页返回全市场最新一期。is_last在 query string 中传字符串"true"，否则部分客户端反序列化会 400。fen_holders中limit_num/unlimit_num等字段可能为空，展示时需做空值处理。