数据服务
股东信息
提供十大股东、十大流通股东、股东户数、股本结构、限售解禁与股权质押数据,按报告期与公告日组织,支持历史回溯。
十大股东股东户数股本结构限售解禁
股东结构反映股权集中度、机构持仓与潜在减持压力。十大股东与十大流通股东是最常用的披露数据,但它们的报告期与公告日往往不同步,直接按报告期回测容易引入前视偏差。
FTLib 提供股东名单、股东户数、股本结构、限售解禁与股权质押等数据,并保留公告日期。研究者可以按报告期观察结构变化,也可以按公告日构建可见面板,用于事件研究与风险筛查。
覆盖范围
股东数据来自定期报告与临时公告。不同披露事项的字段集合不同,接口按数据类型区分;股东名称保留原始文本,并补充标准化类型。
| 项目 | 说明 |
|---|---|
| 十大股东 | 报告期末前十大股东及持股比例 |
| 十大流通股东 | 报告期末前十大流通股东 |
| 股东户数 | 报告期末股东总数、户均持股 |
| 股本结构 | 总股本、流通股本、限售股本 |
| 限售解禁 | 解禁日期、数量、股东类型 |
| 股权质押 | 质押比例、质押股东与公告日期 |
| 覆盖品种 | A 股股票 |
| 接入方式 | REST |
字段说明
持股数量单位为股,比例为百分数。前十名股东与前十名流通股东是两套名单,同一股东可能在两套名单中重复出现。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 证券代码 |
report_period | string | 报告期 |
announce_date | string | 公告日期 |
holder_name | string | 股东名称 |
holder_type | string | 股东类型,如个人、机构、国有股东 |
rank | int | 排名 |
shares | int64 | 持股数量,股 |
ratio | number | 持股比例,百分比 |
change | int64 | 较上期变动,股 |
holder_count | int64 | 股东户数 |
restricted_shares | int64 | 限售股数量 |
release_date | string | 解禁日期 |
请求示例
以下请求获取某只股票最新报告期的十大股东。使用 as_of 可只返回指定日期之前已公告的数据。
十大股东查询
type 可取 top10、top10_float、holder_count、share_structure、restricted_release。
bash
curl -H "Authorization: Bearer $FTLIB_API_KEY" \
"https://api.ftlib.com/v1/shareholders?symbol=600519.SH&type=top10&as_of=2026-11-13"
返回结构
示例数值仅用于说明字段,不代表真实披露数据。
json
{
"code": 0,
"message": "ok",
"request_id": "req_6a2d90cf",
"data": {
"symbol": "600519.SH",
"report_period": "2026Q3",
"announce_date": "2026-10-29",
"items": [
{
"rank": 1,
"holder_name": "示例控股集团",
"holder_type": "institution",
"shares": 678000000,
"ratio": 54.00,
"change": 0
},
{
"rank": 2,
"holder_name": "香港中央结算有限公司",
"holder_type": "connect",
"shares": 92100000,
"ratio": 7.33,
"change": -1250000
}
],
"holder_count": 168420,
"restricted_shares": 0
}
}
数据口径与更新
- 报告期与公告日不同。回测中若按报告期对齐,可能提前使用了尚未披露的股东结构,建议使用公告日或 as_of 参数。
- 十大股东与十大流通股东是不同名单。计算流通盘集中度时应使用流通股东名单,避免把限售股东计入。
- 股东户数通常在定期报告中披露,频率低于行情数据。户均持股可作为筹码集中度的辅助指标,但不宜单独使用。
- 限售解禁数据应结合解禁数量、股东类型与当时价格评估潜在压力;解禁不等于实际减持。
- 股权质押比例来自公告,存在披露滞后。高质押比例是风险观察变量,不是即时交易信号。
名称标准化
股东名称可能存在简称、全称与历史变更。做长期面板时建议维护名称映射,避免把同一股东拆分为多个主体。
典型用法
常见问题
十大股东和十大流通股东有什么区别?
十大股东按总持股排序,可能包含限售股东;十大流通股东只统计可流通股份。计算流通盘集中度应使用后者。
股东数据按报告期还是公告日对齐?
研究历史可见信息时应按公告日对齐;仅观察结构变化可按报告期对齐。接口同时返回两个日期,便于选择。
股东户数多久更新一次?
通常在定期报告中披露,频率低于行情数据。部分公司会在其他公告中更新,具体以披露为准。
解禁日期是否等于可减持日期?
解禁表示限售股份获得上市流通权,但股东仍可能受减持规则、承诺或窗口期限制。解禁不等于立即减持。