财务业绩预告接口文档

查询上市公司业绩预告，包含预告类型、业绩变动区间、净利润区间和摘要。

每日更新

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

请求参数

• apiname（string（finance_forecast），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，可选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，可选）：股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。
• startdate（string，可选）：业务日期区间开始日期。
• enddate（string，可选）：业务日期区间结束日期。
• limit（integer，可选）：本次返回记录数，最大 2000。
• offset（integer，可选）：分页偏移量。
• period（string，可选）：精确报告期，例如 20260331；不能与 date/startdate/enddate 同时传。
• date（string，可选）：精确业务日期。报表类按报告期匹配，事件类按事件日期匹配；不能与 period/startdate/enddate 同时传。
• ann_startdate（string，可选）：披露日期区间开始日期。
• ann_enddate（string，可选）：披露日期区间结束日期。
• as_of（string，可选）：只返回该时点已经披露的数据，支持 YYYYMMDD、YYYY-MM-DD 或 ISO 8601 时间；不传表示当前时点。
• version（string（latest / all），可选）：latest 返回每个业务记录的最新已披露版本；all 返回全部历史版本。

返回字段

• symbol（string）：股票代码
• report_date（string|null）：报告期，格式 YYYYMMDD
• announce_date（string|null）：披露日期，格式 YYYYMMDD
• revision_no（number）：同一业务记录的版本序号
• version_ambiguous（boolean）：是否存在无法仅按披露时点判定先后关系的并列版本
• forecast_type（string|null）：业绩预告类型
• p_change_min（number|null）：业绩变动幅度下限；单位：%
• p_change_max（number|null）：业绩变动幅度上限；单位：%
• net_profit_min（number|null）：预计归母净利润下限；单位：元
• net_profit_max（number|null）：预计归母净利润上限；单位：元
• last_parent_net（number|null）：上年同期归母净利润；单位：元
• first_ann_date（string|null）：首次公告日期，格式 YYYYMMDD
• change_reason（string|null）：业绩变动原因
• update_flag（string|number|null）：记录更新标识
• summary（string|null）：业绩预告摘要