接口文档 / 历史数据 / 公告
历史接口仅查询已发布的数据，查询日期必填。调用次数计入账号每日额度；付费版 100,000 次，旗舰版 300,000 次。
资讯

财务公告接口文档

接口文档数据浏览

查询上市公司公告标题、公告类型、摘要、公告日期和原文链接。

历史库已有 2025—2026 年的保留公告；按可用日期与股票范围查询。保留记录不等于源头全市场完整覆盖，完整性须按日期和股票范围逐批对账；更早年份逐年验证扩展。

单日查询使用 date，按 event_date 筛选；startdate/enddate 查询该日期区间。旧 ann_startdate/ann_enddate 继续按公告日期列 announce_date 筛选，同时传入时取筛选条件的交集。

as_of 按保存的 disclosed_at 截止时间选择版本；公告优先使用源头时间戳，缺少时间戳时可能回落到公告日期零点，不代表 VIP 源头提供分钟级修订历史。date 查询单日全量；symbol/symbols 配合 year 查询整年，仅传股票代码默认上海时区当前自然年，当年无记录返回空，不回退其他年份。year 必须配合股票代码，不能与其他日期条件同时传。单日和股票年度查询默认 all，未传 limit/offset 时一次返回全部保留记录；显式 latest 仍只返回最新版本。旧日期区间查询仍默认 latest 和每页500条，显式分页最大2000条。无股票和日期时查询最新可用日；只读取 90 本地正式记录，不回退日内或 80。

请求地址

POST /api，apiname: finance_announcement

线路请求地址
普通历史节点https://hist.meoz.cn:6688/api
VIP 历史节点https://hist-vip.meoz.cn:6688/api

请求参数

参数类型是否必选示例值描述
apikeystring必选—浏览器中的 Test Request 会在发送时自动注入；其他调用请[前往个人中心获取](/console)。
apinamestring（finance_announcement）必选finance_announcement接口名称
fieldsstring|null可选symbol,event_date,title,summary,announcement_type,content_url| 字段 | 类型 | 名称 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | `symbol` | `string` | 股票代码 | `000001` | 股票代码 | | `event_date` | `string` | 公告披露日期或时间 | `20260724` | 公告披露日期或时间 | | `title` | `string` | 公告标题 | `示例` | 公告标题 | | `summary` | `string\|null` | 公告摘要 | `示例` | 公告摘要 | | `announcement_type` | `string` | 公告类型 | `示例` | 公告类型：financial_report、other 或 unknown | | `content_url` | `string\|null` | 公告原文链接 | `示例` | 公告原文链接 |
paramsobject可选{"date":"20260930"}date 查询单日全量；symbol/symbols + year 查询整年；仅传股票默认当前自然年。旧日期及分页参数继续支持。

params 参数

参数类型是否必选示例值描述
ann_enddatestring可选20261231披露日期区间结束日期。
ann_startdatestring可选20260101披露日期区间开始日期。
announcement_typestring|array<string（financial_report / other / unknown）>可选—按统一公告类型筛选：financial_report=财务报告，other=其他，unknown=未知。
as_ofstring可选2026-07-24T12:00:00+08:00只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。
datestring可选20260331按源头 event_date 查询指定自然日，可配合股票代码；与 year/其他日期区间不能同时传。
enddatestring可选20261231业务日期区间结束日期。
keywordstring可选业绩说明会标题或摘要关键词。
limitinteger可选—可选分页；常用查询不传 limit/offset 时一次返回全部记录。显式 limit 最大2000条。
offsetinteger可选—可选分页；常用查询不传 limit/offset 时一次返回全部记录。显式 offset 不小于0。
periodstring可选20260331精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。
startdatestring可选20260101业务日期区间开始日期。
symbolsstring|array<string>可选000001,600000股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。
versionstring（latest / all）可选all常用单日/年度查询默认 all；显式 latest 返回最新版本，旧日期区间仍默认 latest。
yearinteger可选2026配合股票代码查询整个自然年；仅传代码默认当前自然年。不能与其他日期条件同时传。

返回字段

字段类型名称示例值描述
symbolstring——股票代码
event_datestring——公告披露日期或时间
titlestring——公告标题
summarystring|null——公告摘要
announcement_typestring——公告类型：financial_report、other 或 unknown
content_urlstring|null——公告原文链接

请求与响应样例

{
  "apikey": "YOUR_API_KEY",
  "apiname": "finance_announcement",
  "fields": "symbol,event_date,title,summary,announcement_type,content_url",
  "params": {
    "date": "20260930"
  }
}

相关接口

猫爪数据提供的数据与接口仅用于学习、研究和程序开发，不构成任何投资建议。

本页目录

请求地址请求参数返回字段请求与响应样例