- **功能描述**：获取业绩预告数据
- **返回限量**：单次请求最大返回3500行
- **接口权限**：2000积分：200次/分钟；5000积分：500次/分钟；
- **说明**：
> 1. 上市公司并非随意发布业绩预告，而是在经营业绩出现特定情形时必须进行预告；
> 2. 普通版本接口只能按单支股票或单个公告日获取其历史数据，如果需要获取某一季度全部上市公司数据，则需使用forecast_vip接口；
> 3. 业绩公告会发生更新，依据`update_flag`字段进行识别；

## 输入参数：

| 名称 | 类型 | 必选 | 描述 |
| - | - | - | - |
| ts_code | str | N | 股票代码(二选一) |
| ann_date | str | N | 公告日期 (二选一) |
| start_date | str | N | 公告开始日期 |
| end_date | str | N | 公告结束日期 |
| period | str | N | 报告期(每个季度最后一天的日期，比如20171231表示年报，20170630半年报，20170930三季报) |
| type | str | N | 预告类型(预增/预减/扭亏/首亏/续亏/续盈/略增/略减) |

> 1. `ts_code`和`ann_date`两个参数至少需要传入一个；
> 2. 输入参数中的`end_date`是用来限定`ann_date`的日期范围的，与输出参数不同；

## 输出参数：

| 名称 | 类型 | 默认显示 | 描述 |
| - | - | - | - |
| ts_code | str | Y | TS股票代码 |
| ann_date | str | Y | 公告日期 |
| end_date | str | Y | 报告期 |
| type | str | Y | 业绩预告类型(预增/预减/扭亏/首亏/续亏/续盈/略增/略减) |
| p_change_min | float | Y | 预告净利润变动幅度下限（%） |
| p_change_max | float | Y | 预告净利润变动幅度上限（%） |
| net_profit_min | float | Y | 预告净利润下限（万元） |
| net_profit_max | float | Y | 预告净利润上限（万元） |
| last_parent_net | float | Y | 上年同期归属母公司净利润 |
| notice_times | int | N | 公布次数 |
| first_ann_date | str | Y | 首次公告日 |
| summary | str | Y | 业绩预告摘要 |
| change_reason | str | Y | 业绩变动原因 |
| update_flag | str | Y | 更新标志 |

## 示例：

### 示例1：获取某日公告的业绩预告

通过传递`ann_date`可指定业绩预告的公告日期，`fields`参数可指定返回的字段。

```python
import tushare as ts
pro = ts.pro_api()

df = pro.forecast(ann_date='20190131', fields='ts_code,ann_date,end_date,type,p_change_min,p_change_max,net_profit_min,notice_times')
df
```

输出结果：

```xml
  ts_code ann_date  end_date  type  p_change_min  p_change_max  net_profit_min  notice_times
0 605198.SH 20190131  20181231  其他  40.0000 70.0000 NaN NaN
1 300106.SZ 20190131  20181231  扭亏  104.0870  105.4493  1500.0  2.0
2 300167.SZ 20190131  20181231  续亏  -2464.1590  -2378.6870  -15000.0  1.0
3 300511.SZ 20190131  20181231  略增  10.2900 39.7000 13500.0 1.0
4 300100.SZ 20190131  20181231  预减  -90.0000  -60.0000  2995.0  2.0
... ... ... ... ... ... ... ... ...
727 000609.SZ 20190131  20181231  首亏  -163.2447 -118.6014 -8500.0 1.0
728 002686.SZ 20190131  20181231  预减  -90.0000  -50.0000  1405.0  2.0
729 600175.SH 20190131  20181231  首亏  -1222.8358  -1222.8358  -65000.0  2.0
730 600139.SH 20190131  20181231  扭亏  101.3350  103.3375  800.0 2.0
731 000662.SZ 20190131  20181231  预减  -63.2500  -44.9600  21100.0 1.0
```

### 示例2：获取某支股票某段时间公告的业绩预告

通过传递`ts_code`可指定特定的股票，传递`start_date`和`end_date`可指定公告日的日期范围。

> 通过本示例可知，上市公司并不会每个季度都会公布业绩预告；

```python
df = pro.forecast(ts_code='000001.SZ', start_date='20100101', end_date='20260903')
df
```

输出结果：

```xml
  ts_code ann_date  end_date  type  p_change_min  p_change_max  net_profit_min  net_profit_max  last_parent_net first_ann_date  summary change_reason update_flag
0 000001.SZ 20160121  20151231  略增  5.0 15.0  2079206.0 2277225.0 1980200.0 20160121  预计净利润2079206-2277225万 None  1
1 000001.SZ 20120130  20111231  预增  60.0  70.0  999446.0  1061912.0 628381.6  20120130  净利润约999,446万元~1,061,912万元,增长60%~70% None  1
2 000001.SZ 20111015  20110930  预增  60.0  70.0  754914.0  802096.0  473394.0  20111015  净利润754,914万元~802,096万元,增长60%~70% None  1
3 000001.SZ 20110713  20110630  预增  50.0  60.0  454968.0  485299.0  303311.9  20110713  净利润约454,968万元~485,299万元,增长50%~60% None  1
4 000001.SZ 20110414  20110331  预增  50.0  60.0  236718.0  252499.0  157811.8  20110414  净利润约236718万元~252499万元,增长50%~60% None  1
5 000001.SZ 20100127  20091231  预增  700.0 NaN 500000.0  500000.0  61403.5 20091029  净利润约50亿元,增长超过700% None  1
```

### 示例3：利用VIP版本获取某一季度全部上市公司数据

通过VIP版本的接口（`forecast_vip`）可实现仅传递一个`period`就能够获取某一季度全部上市公司数据。

> 通过查看2025年年报业绩预告的数据量可知并不是所有的上市公司都会公布业绩预告；

```python
df = pro.forecast_vip(period='20251231')
df
```

结果输出：

```xml
  ts_code ann_date  end_date  type  p_change_min  p_change_max  net_profit_min  net_profit_max  last_parent_net first_ann_date  summary change_reason update_flag
0 600187.SH 20260429  20251231  首亏  -593.1481 -593.1481 -21491.0  -21491.0  4357.9200 20260130  预计:净利润-21491 截至本公告披露之日，公司持有诸暨市文盛汇自有资金投资有限公司（简称诸暨文盛汇）36.486%...  0
1 605081.SH 20260429  20251231  续亏  1.8410  16.3831 -32833.0  -27969.0  -33448.8800 20260130  预计:净利润-32833--27969  公司部分项目因存在未批先建、施工资质不符、合规手续缺失、个别项目需按照净额法核算等问题，按照... 0
2 301636.SZ 20260429  20251231  预减  -80.9600  -73.3500  2500.0  3500.0  13131.8200  20260129  预计净利润2500-3500 公司在披露2025年年度业绩预告时，年度审计工作尚未全面展开，相关数据系基于当时已获取的信息... 0
3 603378.SH 20260429  20251231  续亏  -323.6452 -311.4976 -139500.0 -135500.0 -32928.5000 20260131  预计:净利润-139500--135500  公司2025年度审计工作在2026年1月31日时尚未全面结束，公司前次披露的《2025年年度...  0
4 603389.SH 20260428  20251231  续亏  40.1493 53.8294 -7000.0 -5400.0 -11695.7600 20260131  预计:净利润-7000--5400  公司在披露2025年年度业绩预告阶段，年度审计工作尚未全面展开。随着年度审计工作的推进及资产... 0
... ... ... ... ... ... ... ... ... ... ... ... ... ...
3174  920003.BJ 20250703  20251231  略减  -4.1409 -4.1409 10102.0 10102.0 10538.8500  20250703  预计:净利润10102  None  0
3175  301616.SZ 20250314  20251231  略增  5.4500  15.1300 9800.0  10700.0 9293.8300 20250314  预计:净利润9800-10700 None  0
3176  688235.SH 20250228  20251231  不确定  NaN NaN NaN NaN -497828.7000  20250228  不确定  收入强劲增长的预期主要受益于百悦泽？在美国的领先地位以及在欧洲和全球其他重要市场的持续扩张；... 0
3177  688082.SH 20250115  20251231  不确定  NaN NaN NaN NaN 115318.8090 20260115  不确定  None  0
3178  600157.SH 20240808  20251231  不确定  NaN NaN 280000.0  280000.0  156055.0126 20240808  预计:净利润280000 近年来，公司全面贯彻落实国家能源安全战略和“碳达峰、碳中和”决策部署，聚焦能源主业，坚持“煤...  0
3179 rows × 13 columns
```

## 说明：

### 说明1：业绩预告公告的说明

上市公司并非随意发布业绩预告，而是在经营业绩出现特定情形时必须进行预告。这些情形主要包括:
- 净利润为负值（亏损）。
- 净利润实现扭亏为盈。
- 净利润与上年同期相比上升或下降50%以上。
- 期末净资产为负值等。
对于年度业绩预告，上市公司最晚需要在会计年度结束后的一个月内（即次年1月31日前）进行披露。对于一季度、半年度等预告，也有相应的最晚披露时间。

### 说明2：本文说明

该接口返回上市公司的业绩预告数据，包括预告类型、净利润变动幅度（上下限）、净利润金额（上下限）、上年同期净利润、业绩变动原因等关键信息。业绩预告是上市公司在正式财报发布前，提前向市场披露的当期经营业绩预测，对股价有重要的影响。

普通版本接口只能按单支股票或单个公告日获取其历史数据，如果需要获取某一季度全部上市公司数据，则需使用forecast_vip接口；

Tushare接口文档：业绩预告（forecast）

该接口返回上市公司的业绩预告数据，包括预告类型、净利润变动幅度（上下限）、净利润金额（上下限）、上年同期净利润、业绩变动原因等关键信息。业绩预告是上市公司在正式财报发布前，提前向市场披露的当期经营业绩预测，对股价有重要的影响。

首席数据运营官

数据库

开发工具

后端

获取A股上市公司业绩预告数据，支持按股票代码、公告日期、报告期筛选，涵盖预增、预减、扭亏等类型，提供净利润变动幅度及金额上下限、业绩变动原因等关键指标，普通版与VIP版满足不同查询需求。

代码解释

2026上云采购 | AI焕新·智启新局

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Tushare接口文档：业绩预告（forecast）-腾讯云开发者社区-腾讯云

Tushare接口文档：业绩预告（forecast）

Tushare接口文档：业绩预告（forecast）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐