股东户数
查询上市公司股东户数及对应统计日期、披露日期。
历史数据接口标识
finance_holder_number文档 v1.0.0请求
| 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 | 股票代码 | 股票代码 | 000001 | string |
report_date | 报告期 | 报告期，格式 YYYYMMDD | 20260331 | string|null |
announce_date | 披露日期 | 披露日期，格式 YYYYMMDD | 20260422 | string|null |
revision_no | 同一业务记录的版本序号 | 同一业务记录的版本序号 | 1.23 | number |
version_ambiguous | 是否存在无法仅按披露时点判定先后关系的并列版本 | 是否存在无法仅按披露时点判定先后关系的并列版本 | false | boolean |
holder_num | 股东户数（户） | 股东户数；单位：户 | 1.23 | number|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 | integer |
offset | 分页偏移量。 可选 | 0 | integer |
period | 精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。 可选 | 20260331 | string |
startdate | 业务日期区间开始日期。 可选 | 20260101 | string |
symbols | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 可选 | 000001,600000 | string | string[] |
version | latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。 可选 | latest | string |
请求示例
使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例，语言库要求在代码中注明。
{ "apikey": "YOUR_API_KEY", "apiname": "finance_holder_number", "fields": "symbol,report_date,announce_date,revision_no,version_ambiguous,holder_num", "params": { "enddate": "20261231", "startdate": "20260101", "symbols": "000001,600000" }}响应
响应体
| 字段 | 说明 | 类型 |
|---|---|---|
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", "holder_num" ], "items": [ [ "000001", "20260331", "20260422", 1.23, false, 1.23 ] ], "limit": 500, "offset": 0, "total": 1 }, "message": "success"}