股本股东

财务股本变动接口文档

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

每日更新

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

POST/apiapiname:finance_capital

生产专线（默认）深圳http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api

请求参数

参数	类型	是否必选	示例值	描述
`apiname`	string（finance_capital）	必选	`finance_capital`	固定接口名称，用于选择对应的数据能力。
`apikey`	string	必选	`—`	猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
`fields`	string\|null	可选	`symbol,event_date,announce_date,revision_no,version_ambiguous,total_capital,circulating_capital,restrict_circulating_capital,free_float_capital`	需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
`params`	object	可选	`{"symbols":"000001,600000","startdate":"20260101","enddate":"20261231"}`	查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。

`params` 参数

参数	类型	是否必选	示例值	描述
`symbols`	string\|array<string>	可选	`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 / all）	可选	`latest`	latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。

`fields` 返回字段

字段顺序与接口样例保持一致

字段	类型	名称	示例值	描述
`symbol`	string	—	`—`	股票代码
`report_date`	string\|null	—	`—`	报告期，格式 YYYYMMDD
`announce_date`	string\|null	—	`—`	披露日期，格式 YYYYMMDD
`revision_no`	number	—	`—`	同一业务记录的版本序号
`version_ambiguous`	boolean	—	`—`	是否存在无法仅按披露时点判定先后关系的并列版本
`event_date`	string	—	`—`	股本实际变动日期，格式 YYYYMMDD
`total_capital`	number\|null	—	`—`	总股本；单位：股
`circulating_capital`	number\|null	—	`—`	流通股本；单位：股
`restrict_circulating_capital`	number\|null	—	`—`	限售流通股本；单位：股
`free_float_capital`	number\|null	—	`—`	自由流通股本；单位：股

请求与响应样例

固定样例

{
  "apiname": "finance_capital",
  "apikey": "YOUR_API_KEY",
  "fields": "symbol,event_date,announce_date,revision_no,version_ambiguous,total_capital,circulating_capital,restrict_circulating_capital,free_float_capital",
  "params": {
    "symbols": "000001,600000",
    "startdate": "20260101",
    "enddate": "20261231"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "symbol",
      "event_date",
      "announce_date",
      "revision_no",
      "version_ambiguous",
      "total_capital",
      "circulating_capital",
      "restrict_circulating_capital",
      "free_float_capital"
    ],
    "items": [
      [
        "000001",
        "20260724",
        "20260422",
        1.23,
        false,
        1.23,
        1.23,
        1.23,
        1.23
      ]
    ],
    "total": 1,
    "limit": 500,
    "offset": 0
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

相关接口

`params` 参数

`fields` 返回字段