十大流通股东

文档 v1.0.67 · 发布快照 1.0.78下载 meoz Skill最新文档

根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。

正式接口 · meoz 接口目录

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

每日更新

历史覆盖:2026 年至今(首期回填范围)

仅查询90本地已发布数据;不指定日期时读取最近已发布业务窗口,不回退80。

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

接口名称 finance_top10_float_holder

请求方法 POST /api

  • https://hist.meoz.cn:6688
  • https://hist-vip.meoz.cn:6688

返回字段

字段 名称 类型 描述 单位
symbol string 股票代码
report_date string|null 报告期,格式 YYYYMMDD
announce_date string|null 披露日期,格式 YYYYMMDD
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 股东分类(源端原值)

请求

{"content":{"application/json":{"example":{"apikey":"","apiname":"finance_top10_float_holder","params":{"period":"20260331","symbols":"000001"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"finance_top10_float_holder","description":"接口名称","enum":["finance_top10_float_holder"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"VIP 原字段契约:不传 fields 默认返回完整源字段,保留大小写、m_ 字段、零值和空值;新观测字段也随结果返回。显式 fields 保持请求顺序,不存在的旧字段返回 null,不因字段变化报错。财务字段含义及单位以 VIP 源定义为准,不再添加 Tushare 别名。仅返回可关联 VIP 原始报文的记录;历史缺口不回退 Tushare,空结果不代表源头完整覆盖。\n\n| 字段 | 类型 | 描述 |\n| --- | --- | --- |\n| `symbol` | `string` | 股票代码 |\n| `report_date` | `string\\|null` | 报告期,格式 YYYYMMDD |\n| `announce_date` | `string\\|null` | 披露日期,格式 YYYYMMDD |\n| `revision_no` | `number` | 保存记录的版本序号 |\n| `version_ambiguous` | `boolean` | 是否存在并列修订版本 |\n| `declareDate` | `string\\|null` | 公告日期 |\n| `endDate` | `string\\|null` | 截止日期 |\n| `name` | `string\\|null` | 股东名称 |\n| `type` | `string\\|null` | 股东类型 |\n| `quantity` | `number\\|null` | 持股数量 |\n| `reason` | `string\\|null` | 变动原因 |\n| `ratio` | `number\\|null` | 持股比例 |\n| `nature` | `string\\|null` | 股份性质 |\n| `rank` | `number\\|null` | 持股排名 |\n| `cType` | `string\\|null` | 股东分类(源端原值) |"},"params":{"additionalProperties":false,"default":{"period":"20260331","symbols":"000001"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 可选 | `000001,600000` | 股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。 |\n| `startdate` | `string` | 可选 | `20260101` | 业务日期区间开始日期。 |\n| `enddate` | `string` | 可选 | `20261231` | 业务日期区间结束日期。 |\n| `limit` | `integer` | 可选 | `500` | 本次返回记录数,最大 2000。 |\n| `offset` | `integer` | 可选 | `0` | 分页偏移量。 |\n| `period` | `string` | 可选 | `20260331` | 精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。 |\n| `date` | `string` | 可选 | `20260331` | 精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。 |\n| `ann_startdate` | `string` | 可选 | `20260101` | 披露日期区间开始日期。 |\n| `ann_enddate` | `string` | 可选 | `20261231` | 披露日期区间结束日期。 |\n| `as_of` | `string` | 可选 | `2026-07-24T12:00:00+08:00` | 只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。 |\n| `version` | `string` | 可选 | `latest` | latest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。 |","properties":{"ann_enddate":{"description":"披露日期区间结束日期。","example":"20261231","type":"string"},"ann_startdate":{"description":"披露日期区间开始日期。","example":"20260101","type":"string"},"as_of":{"description":"只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。","example":"2026-07-24T12:00:00+08:00","type":"string"},"date":{"description":"精确业务日期。报表类按报告期匹配,事件类按事件日期匹配;不能与 period/startdate/enddate 同时传。","example":"20260331","pattern":"^\\d{8}$","type":"string"},"enddate":{"description":"业务日期区间结束日期。","example":"20261231","pattern":"^\\d{8}$","type":"string"},"limit":{"default":500,"description":"本次返回记录数,最大 2000。","maximum":2000,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"分页偏移量。","minimum":0,"type":"integer"},"period":{"description":"精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。","example":"20260331","type":"string"},"startdate":{"description":"业务日期区间开始日期。","example":"20260101","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。","example":"000001,600000","oneOf":[{"description":"单个或多个逗号分隔股票代码","type":"string"},{"description":"股票代码数组","items":{"type":"string"},"type":"array"}]},"version":{"default":"latest","description":"latest 返回每个业务记录的最新已披露版本;all 返回全部历史版本。","enum":["latest","all"],"type":"string"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `finance_top10_float_holder` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}

响应

{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"十大流通股东分页返回结果","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["symbol","report_date","announce_date","revision_no","version_ambiguous","declareDate","endDate","name","type","quantity","reason","ratio","nature","rank","cType"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条财务业务记录,列顺序与 fields 一一对应","example":[["000001","20260331","20260422",1,false,null,null,null,null,null,null,null,null,null,null]],"items":{"items":{},"type":"array"},"type":"array"},"limit":{"description":"本次请求的最大返回记录数","example":500,"type":"integer"},"offset":{"description":"本次请求的分页偏移量","example":0,"type":"integer"},"total":{"description":"符合查询条件的记录总数","example":1,"type":"integer"}},"required":["fields","items","total","limit","offset"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}