财务股东户数接口文档

查询上市公司股东户数及对应统计日期、披露日期。

每日更新

历史覆盖：2026 年至今（首期回填范围）

请求参数

• apikey（string，必选）：浏览器中的 Test Request 会在发送时自动注入；其他调用请[前往个人中心获取](/console)。
• apiname（string（finance_holder_number），必选）：接口名称
• fields（string|null，可选）：| 字段 | 类型 | 名称 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbol` | `string` | 股票代码 | `000001` | 股票代码 | | `report_date` | `string\|null` | 报告期 | `20260331` | 报告期，格式 YYYYMMDD | | `announce_date` | `string\|null` | 披露日期 | `20260422` | 披露日期，格式 YYYYMMDD | | `revision_no` | `number` | 同一业务记录的版本序号 | `1.23` | 同一业务记录的版本序号 | | `version_ambiguous` | `boolean` | 是否存在无法仅按披露时点判定先后关系的并列版本 | `false` | 是否存在无法仅按披露时点判定先后关系的并列版本 | | `holder_num` | `number\|null` | 股东户数（户） | `1.23` | 股东户数 |
• params（object，可选）：| 参数 | 类型 | 是否必选 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbols` | `string\|array` | 可选 | `000001,600000` | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 | | `startdate` | `string` | 可选 | `20260101` | 业务日期区间开始日期。 | | `enddate` | `string` | 可选 | `20261231` | 业务日期区间结束日期。 | | `limit` | `integer` | 可选 | `500` | 本次返回记录数，最大 2000。 | | `offset` | `integer` | 可选 | `0` | 分页偏移量。 | | `period` | `string` | 可选 | `20260331` | 精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。 | | `date` | `string` | 可选 | `20260331` | 精确业务日期。报表类按报告期匹配，事件类按事件日期匹配；不能与 period/startdate/enddate 同时传。 | | `ann_startdate` | `string` | 可选 | `20260101` | 披露日期区间开始日期。 | | `ann_enddate` | `string` | 可选 | `20261231` | 披露日期区间结束日期。 | | `as_of` | `string` | 可选 | `2026-07-24T12:00:00+08:00` | 只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。 | | `version` | `string` | 可选 | `latest` | latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。 |
• ann_enddate（string，可选）：披露日期区间结束日期。
• ann_startdate（string，可选）：披露日期区间开始日期。
• as_of（string，可选）：只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。
• date（string，可选）：精确业务日期。报表类按报告期匹配，事件类按事件日期匹配；不能与 period/startdate/enddate 同时传。
• enddate（string，可选）：业务日期区间结束日期。
• limit（integer，可选）：本次返回记录数，最大 2000。
• offset（integer，可选）：分页偏移量。
• period（string，可选）：精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。
• startdate（string，可选）：业务日期区间开始日期。
• symbols（string|array<string>，可选）：股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。
• version（string（latest / all），可选）：latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。

返回字段

• symbol（string）：股票代码
• report_date（string|null）：报告期，格式 YYYYMMDD
• announce_date（string|null）：披露日期，格式 YYYYMMDD
• revision_no（number）：同一业务记录的版本序号
• version_ambiguous（boolean）：是否存在无法仅按披露时点判定先后关系的并列版本
• holder_num（number|null）：股东户数；单位：户