公告
根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。
查询上市公司公告标题、公告类型、摘要、公告日期和原文链接。
历史库已有 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。
查询上市公司公告标题、公告类型、摘要、公告日期和原文链接。
历史库已有 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
请求方法 POST /api
- https://hist.meoz.cn:6688
- https://hist-vip.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| symbol | string | 股票代码 | ||
| event_date | string | 公告披露日期或时间 | ||
| title | string | 公告标题 | ||
| summary | string|null | 公告摘要 | ||
| announcement_type | string | 公告类型:financial_report、other 或 unknown | ||
| content_url | string|null | 公告原文链接 |
请求
{"content":{"application/json":{"example":{"apikey":"","apiname":"finance_announcement","fields":"symbol,event_date,title,summary,announcement_type,content_url","params":{"date":"20260930"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"finance_announcement","description":"接口名称","enum":["finance_announcement"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"symbol,event_date,title,summary,announcement_type,content_url","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbol` | `string` | 股票代码 | `000001` | 股票代码 |\n| `event_date` | `string` | 公告披露日期或时间 | `20260724` | 公告披露日期或时间 |\n| `title` | `string` | 公告标题 | `示例` | 公告标题 |\n| `summary` | `string\\|null` | 公告摘要 | `示例` | 公告摘要 |\n| `announcement_type` | `string` | 公告类型 | `示例` | 公告类型:financial_report、other 或 unknown |\n| `content_url` | `string\\|null` | 公告原文链接 | `示例` | 公告原文链接 |"},"params":{"additionalProperties":false,"default":{"date":"20260930"},"description":"date 查询单日全量;symbol/symbols + year 查询整年;仅传股票默认当前自然年。旧日期及分页参数继续支持。","properties":{"ann_enddate":{"description":"披露日期区间结束日期。","example":"20261231","type":"string"},"ann_startdate":{"description":"披露日期区间开始日期。","example":"20260101","type":"string"},"announcement_type":{"description":"按统一公告类型筛选:financial_report=财务报告,other=其他,unknown=未知。","oneOf":[{"description":"单个或多个逗号分隔值:financial_report、other、unknown","type":"string"},{"description":"公告类型数组","items":{"enum":["financial_report","other","unknown"],"type":"string"},"type":"array"}]},"as_of":{"description":"只返回该时点已经披露的数据,支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间;不传表示当前时点。","example":"2026-07-24T12:00:00+08:00","type":"string"},"date":{"description":"按源头 event_date 查询指定自然日,可配合股票代码;与 year/其他日期区间不能同时传。","example":"20260331","pattern":"^\\d{8}$","type":"string"},"enddate":{"description":"业务日期区间结束日期。","example":"20261231","pattern":"^\\d{8}$","type":"string"},"keyword":{"description":"标题或摘要关键词。","example":"业绩说明会","type":"string"},"limit":{"description":"可选分页;常用查询不传 limit/offset 时一次返回全部记录。显式 limit 最大2000条。","maximum":2000,"minimum":1,"type":"integer"},"offset":{"description":"可选分页;常用查询不传 limit/offset 时一次返回全部记录。显式 offset 不小于0。","minimum":0,"type":"integer"},"period":{"description":"精确报告期,例如 20260331;不能与 date/startdate/enddate 同时传。","example":"20260331","type":"string"},"startdate":{"description":"业务日期区间开始日期。","example":"20260101","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。","example":"000001,600000","oneOf":[{"description":"单个或多个逗号分隔股票代码","type":"string"},{"description":"股票代码数组","items":{"type":"string"},"type":"array"}]},"version":{"default":"all","description":"常用单日/年度查询默认 all;显式 latest 返回最新版本,旧日期区间仍默认 latest。","enum":["latest","all"],"type":"string"},"year":{"description":"配合股票代码查询整个自然年;仅传代码默认当前自然年。不能与其他日期条件同时传。","example":2026,"maximum":9999,"minimum":1000,"type":"integer"}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `finance_announcement` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"公司公告分页返回结果","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["symbol","event_date","title","summary","announcement_type","content_url"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条上市公司公告","example":[["000001","20260724","示例","示例","示例","示例"]],"items":{"items":{},"type":"array"},"type":"array"},"limit":{"description":"本次请求的最大返回记录数","example":500,"type":"integer"},"offset":{"description":"本次请求的分页偏移量","example":0,"type":"integer"},"total":{"description":"符合查询条件的记录总数","example":1,"type":"integer"}},"required":["fields","items","total","limit","offset"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}