十大流通股东

数据浏览

查询上市公司各报告期十大流通股东名单、持股数量、持股比例和排名。

历史数据接口标识 finance_top10_float_holder文档 ID history/finance/top10-float-holder文档 v1.0.52

下载此接口 OpenAPI

数据范围与限制

已发布的范围与限制说明:查询上市公司各报告期十大流通股东名单、持股数量、持股比例和排名。 每日更新 历史覆盖:2026 年至今(首期回填范围) 仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。 VIP 原字段契约:不传 fields 默认返回完整源字段,保留大小写、m_ 字段、零值和空值;新观测字段也随结果返回。显式 fields 保持请求顺序,不存在的旧字段返回 null,不因字段变化报错。财务字段含义及单位以 VIP 源定义为准,不再添加 Tushare 别名。仅返回可关联 VIP 原始报文的记录;历史缺口不回退 Tushare,空结果不代表源头完整覆盖。 未单独标注的起止日期、市场、资产范围及逐标的数据完整性尚未确认;示例日期不代表完整覆盖。

请求

HTTP URLhttps://hist.meoz.cn:6688/api
HTTP URLhttps://hist-vip.meoz.cn:6688/api
HTTP MethodPOST

请求头

Content-Type: application/json

请求体

apikey

类型:string必填

浏览器中的 Test Request 会在发送时自动注入;其他调用请前往个人中心获取。 默认值:""。

apiname

类型:string(finance_top10_float_holder)必填

接口名称 默认值:"finance_top10_float_holder"。

fields

类型:string|null可选

VIP 原字段契约:不传 fields 默认返回完整源字段,保留大小写、m_ 字段、零值和空值;新观测字段也随结果返回。显式 fields 保持请求顺序,不存在的旧字段返回 null,不因字段变化报错。财务字段含义及单位以 VIP 源定义为准,不再添加 Tushare 别名。仅返回可关联 VIP 原始报文的记录;历史缺口不回退 Tushare,空结果不代表源头完整覆盖。

字段描述示例类型
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

params

类型:object可选

查询条件;参数格式与使用要求见下表。 默认值:{"period":"20260331","symbols":"000001"}。

字段描述示例类型
ann_enddate披露日期区间结束日期。
可选
20261231string
ann_startdate披露日期区间开始日期。
可选
20260101string
as_of只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。
可选
2026-07-24T12:00:00+08:00string
date精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。
可选
20260331string
enddate业务日期区间结束日期。
可选
20261231string
limit本次返回记录数,最大 2000。 默认值:500。
可选
500integer
offset分页偏移量。 默认值:0。
可选
0integer
period精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。
可选
20260331string
startdate业务日期区间开始日期。
可选
20260101string
symbols股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。
可选
000001,600000string | string[]
versionlatest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。 默认值:"latest"。
可选
lateststring

请求示例

使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例,语言库要求在代码中注明。

基础查询

数据浏览
基础查询 · JSON
{  "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"}