公告
查询上市公司公告标题、公告类型、摘要、公告日期和原文链接。
历史库已有 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。
历史数据接口标识
finance_announcement文档 v1.0.15请求
| 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 | 股票代码 | 股票代码 | — | string |
event_date | 公告披露日期或时间 | 公告披露日期或时间 | — | string |
title | 公告标题 | 公告标题 | — | string |
summary | 公告摘要 | 公告摘要 | — | string|null |
announcement_type | 公告类型 | 公告类型：financial_report、other 或 unknown | — | string |
content_url | 公告原文链接 | 公告原文链接 | — | string|null |
| 字段 | 描述 | 示例 | 类型 |
|---|---|---|---|
ann_enddate | 披露日期区间结束日期。 可选 | 20261231 | string |
ann_startdate | 披露日期区间开始日期。 可选 | 20260101 | string |
announcement_type | 按统一公告类型筛选：financial_report=财务报告，other=其他，unknown=未知。 可选 | — | string | string[] |
as_of | 只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。 可选 | 2026-07-24T12:00:00+08:00 | string |
date | 按源头 event_date 查询指定自然日，可配合股票代码；与 year/其他日期区间不能同时传。 可选 | 20260331 | string |
enddate | 业务日期区间结束日期。 可选 | 20261231 | string |
keyword | 标题或摘要关键词。 可选 | 业绩说明会 | string |
limit | 可选分页；常用查询不传 limit/offset 时一次返回全部记录。显式 limit 最大2000条。 可选 | — | integer |
offset | 可选分页；常用查询不传 limit/offset 时一次返回全部记录。显式 offset 不小于0。 可选 | — | integer |
period | 精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。 可选 | 20260331 | string |
startdate | 业务日期区间开始日期。 可选 | 20260101 | string |
symbols | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 可选 | 000001,600000 | string | string[] |
version | 常用单日/年度查询默认 all；显式 latest 返回最新版本，旧日期区间仍默认 latest。 可选 | all | string |
year | 配合股票代码查询整个自然年；仅传代码默认当前自然年。不能与其他日期条件同时传。 可选 | 2026 | integer |
请求示例
使用自己的 API Key 替换 YOUR_API_KEY。以下均为直接 HTTP 调用示例，语言库要求在代码中注明。
{ "apikey": "YOUR_API_KEY", "apiname": "finance_announcement", "fields": "symbol,event_date,title,summary,announcement_type,content_url", "params": { "date": "20260930" }}响应
响应体
| 字段 | 说明 | 类型 |
|---|---|---|
code | 业务状态码，200 表示成功 | integer |
| 公司公告分页返回结果 | object | null | |
fields | 返回字段名列表，顺序与 items 中每一列一一对应 | string[] |
items | 二维数组数据，每一行代表一条上市公司公告 | any[][] |
limit | 本次请求的最大返回记录数 | integer |
offset | 本次请求的分页偏移量 | integer |
total | 符合查询条件的记录总数 | integer |
message | 响应消息 | string |
响应体示例
{ "code": 200, "data": { "fields": [ "symbol", "event_date", "title", "summary", "announcement_type", "content_url" ], "items": [ [ "000001", "20260724", "示例", "示例", "示例", "示例" ] ], "limit": 500, "offset": 0, "total": 1 }, "message": "success"}