十大流通股东
查询上市公司各报告期十大流通股东名单、持股数量、持股比例和排名。
历史数据接口标识
finance_top10_float_holder文档 ID history/finance/top10-float-holder文档 v1.0.52数据范围与限制
已发布的范围与限制说明:查询上市公司各报告期十大流通股东名单、持股数量、持股比例和排名。 每日更新 历史覆盖:2026 年至今(首期回填范围) 仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。 VIP 原字段契约:不传 fields 默认返回完整源字段,保留大小写、m_ 字段、零值和空值;新观测字段也随结果返回。显式 fields 保持请求顺序,不存在的旧字段返回 null,不因字段变化报错。财务字段含义及单位以 VIP 源定义为准,不再添加 Tushare 别名。仅返回可关联 VIP 原始报文的记录;历史缺口不回退 Tushare,空结果不代表源头完整覆盖。 未单独标注的起止日期、市场、资产范围及逐标的数据完整性尚未确认;示例日期不代表完整覆盖。
请求
| HTTP URL | https://hist.meoz.cn:6688/api |
|---|---|
| HTTP URL | https://hist-vip.meoz.cn:6688/api |
| HTTP Method | POST |
请求头
Content-Type: application/json
请求体
| 字段 | 描述 | 示例 | 类型 |
|---|---|---|---|
symbol | 股票代码 | — | string |
report_date | 报告期,格式 YYYYMMDD | — | string|null |
announce_date | 披露日期,格式 YYYYMMDD | — | string|null |
revision_no | 保存记录的版本序号 | — | number |
version_ambiguous | 是否存在并列修订版本 | — | boolean |
declareDate | 公告日期 | — | string|null |
endDate | 截止日期 | — | string|null |
name | 股东名称 | — | string|null |
type | 股东类型 | — | string|null |
quantity | 持股数量 | — | number|null |
reason | 变动原因 | — | string|null |
ratio | 持股比例 | — | number|null |
nature | 股份性质 | — | string|null |
rank | 持股排名 | — | number|null |
cType | 股东分类(源端原值) | — | string|null |
| 字段 | 描述 | 示例 | 类型 |
|---|---|---|---|
ann_enddate | 披露日期区间结束日期。 可选 | 20261231 | string |
ann_startdate | 披露日期区间开始日期。 可选 | 20260101 | string |
as_of | 只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。 可选 | 2026-07-24T12:00:00+08:00 | string |
date | 精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。 可选 | 20260331 | string |
enddate | 业务日期区间结束日期。 可选 | 20261231 | string |
limit | 本次返回记录数,最大 2000。 默认值:500。 可选 | 500 | integer |
offset | 分页偏移量。 默认值:0。 可选 | 0 | integer |
period | 精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。 可选 | 20260331 | string |
startdate | 业务日期区间开始日期。 可选 | 20260101 | string |
symbols | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 可选 | 000001,600000 | string | string[] |
version | latest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。 默认值:"latest"。 可选 | latest | string |
请求示例
使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例,语言库要求在代码中注明。
{ "apikey": "YOUR_API_KEY", "apiname": "finance_top10_float_holder", "params": { "period": "20260331", "symbols": "000001" }}响应
响应体
Successful Response
| 字段 | 说明 | 类型 |
|---|---|---|
code | 业务状态码,200 表示成功 | integer |
| 十大流通股东分页返回结果 | object | null | |
fields | 返回字段名列表,顺序与 items 中每一列一一对应 | string[] |
items | 二维数组数据,每一行代表一条财务业务记录,列顺序与 fields 一一对应 | any[][] |
limit | 本次请求的最大返回记录数 | integer |
offset | 本次请求的分页偏移量 | integer |
total | 符合查询条件的记录总数 | integer |
message | 响应消息 | string |
响应体示例
由已发布字段示例组合,用于说明响应结构,不是实际查询结果。
{ "code": 200, "data": { "fields": [ "symbol", "report_date", "announce_date", "revision_no", "version_ambiguous", "declareDate", "endDate", "name", "type", "quantity", "reason", "ratio", "nature", "rank", "cType" ], "items": [ [ "000001", "20260331", "20260422", 1, false, null, null, null, null, null, null, null, null, null, null ] ], "limit": 500, "offset": 0, "total": 1 }, "message": "success"}