股本变动

数据浏览

查询上市公司股本变动事件,按实际变动日期返回总股本、流通股本等数据。

历史数据接口标识 finance_capital文档 ID history/finance/capital文档 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_capital)必填

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

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
total_capital总股本—number|null
circulating_capital已上市流通A股—number|null
restrict_circulating_capital限售流通股份—number|null
m_timetag变动日期—string|null
m_anntime公告日—string|null
free_float_capital自由流通股本—number|null

params

类型:object可选

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

字段描述示例类型
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_capital",  "params": {    "enddate": "20261231",    "startdate": "20260101",    "symbols": "000001,600000"  }}

响应

响应体

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",      "total_capital",      "circulating_capital",      "restrict_circulating_capital",      "m_timetag",      "m_anntime",      "free_float_capital"    ],    "items": [      [        "000001",        "20260331",        "20260422",        1,        false,        null,        null,        null,        null,        null,        null      ]    ],    "limit": 500,    "offset": 0,    "total": 1  },  "message": "success"}