# A 股历年三大财务报表
> 来源页面: https://www.gugudata.com/api/details/cnannualreport
## 概览
- API 标识: `cnannualreport`
- 分类: 金融/基础
- 描述: 历年所有财报数据
- 标签: 全量A股数据 / 最全三大财报数据
- 短标签: 股票 / A股
- 详情页: https://www.gugudata.com/api/details/cnannualreport
- LLM Markdown: https://www.gugudata.com/api/details/cnannualreport/llm.md
- 数据预览: https://www.gugudata.com/preview/cnannualreport
- 购买开通: https://www.gugudata.com/order/cnannualreport
- APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## 给大模型的接入指令
如果你正在帮助用户接入这个 API，请优先使用本文档中的接口地址、请求方式、请求参数、返回参数、状态码、cURL 示例和预览数据生成代码或排查问题。
- 接入目标: 调用 `A 股历年三大财务报表`，不要臆造未在文档中出现的参数或返回字段。
- AppKey 获取: 用户登录咕咕数据开发者中心后，在 `APP KEY 管理` 页面复制对应产品的 AppKey。
- AppKey 替换: 示例中的 `YOUR_APPKEY`、`APPKEY`、`{{YOUR_APPKEY}}`、`{{appkey}}`、`{{appKey}}` 都应替换为用户自己的 AppKey。
- 开通与续费: 未开通时引导用户访问购买开通页；已开通或需要续费时，引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果，响应体内的业务状态码代表接口业务结果，代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中，由服务端统一发起请求，不要写入网页、App 客户端或公开仓库。
关键链接:
- 接口详情页: https://www.gugudata.com/api/details/cnannualreport
- LLM Markdown: https://www.gugudata.com/api/details/cnannualreport/llm.md
- 数据预览: https://www.gugudata.com/preview/cnannualreport
- 购买开通页: https://www.gugudata.com/order/cnannualreport
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## API 功能
- 支持所有 A 股全量三大财报数据查询；
- 分别包括资产负债表、利润表、现金流量表数据；
- 返回 70 多项财务指标；
- 多数据源清洗整合，百万级数据毫秒级返回；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡。
- 接口调用状态与状态监控: https://www.gugudata.com/status
## API 文档
- 接口地址: `https://api.gugudata.com/stock/cn/annualreport`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `GET`
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=`
- 接口测试: https://api.gugudata.com/stock/cn/annualreport/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official/collection/1163860-ee114343-4622-4a54-a39b-994173c27dac/?action=share&creator=1163860&active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
### 前置接口
- 前置接口说明: 查询 A 股股票代码列表数据，支持分页查询
- 前置接口地址: https://api.gugudata.com/stock/cnsymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE
- 前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量，最大 50 条
- 前置接口返回格式: `application/json; charset=utf-8`
- 前置接口返回说明: 包含股票编码、股票名称、股票中文名称
- 前置接口请求方式: `GET`
- 前置接口请求协议: `HTTPS`
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| symbol | string | 否 | YOUR_VALUE | 传递单支股票代码，如: 600031。可通过前置接口或参见 A 股股票代码参数枚举页面 |
| type | string | 是 | | 三大财报类型，可选值为：资产负债表\|利润表\|现金流量表 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.StatusCode | integer | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | integer | 此条件下的总数据量，一般用于分页计算 |
| Data.columns | array | 财报的数据列名称，注意因为财报数据字段非常多且为了保证表达精准性，这里的字段说明以中文进行表达。 |
| Data.data | array | 对应时间点的具体财报数据 |
| Data.data.资产负债表 | array | 资产负债表.报表日期 资产负债表.单位 资产负债表.资产 资产负债表.现金及存放中央银行款项 资产负债表.存放同业款项 资产负债表.拆出资金 资产负债表.贵金属 资产负债表.交易性金融资产 资产负债表.衍生金融工具资产 资产负债表.买入返售金融资产 资产负债表.应收利息 资产负债表.发放贷款及垫款 资产负债表.代理业务资产 资产负债表.可供出售金融资产 资产负债表.持有至到期投资 资产负债表.长期股权投资 资产负债表.应收投资款项 资产负债表.固定资产合计 资产负债表.无形资产 资产负债表.商誉 资产负债表.递延税款借项 资产负债表.投资性房地产 资产负债表.其他资产 资产负债表.资产总计 资产负债表.负债 资产负债表.向中央银行借款 资产负债表.同业存入及拆入 资产负债表.其中:同业存放款项 资产负债表.拆入资金 资产负债表.衍生金融工具负债 资产负债表.交易性金融负债 资产负债表.卖出回购金融资产款 资产负债表.客户存款(吸收存款) 资产负债表.应付职工薪酬 资产负债表.应交税费 资产负债表.应付利息 资产负债表.应付账款 资产负债表.代理业务负债 资产负债表.应付债券 资产负债表.递延所得税负债 资产负债表.预计负债 资产负债表.其他负债 资产负债表.负债合计 资产负债表.所有者权益 资产负债表.股本 资产负债表.其他权益工具 资产负债表.其中：优先股 资产负债表.资本公积 资产负债表.减:库藏股 资产负债表.其他综合收益 资产负债表.盈余公积 资产负债表.未分配利润 资产负债表.一般风险准备 资产负债表.外币报表折算差额 资产负债表.其他储备 资产负债表.归属于母公司股东的权益 资产负债表.少数股东权益 资产负债表.股东权益合计 资产负债表.负债及股东权益总计 |
| Data.data.利润表 | array | 利润表.报表日期 利润表.单位 利润表.一、营业收入 利润表.利息净收入 利润表.其中：利息收入 利润表.减：利息支出 利润表.手续费及佣金净收入 利润表.其中:手续费及佣金收入 利润表.减：手续费及佣金支出 利润表.汇兑收益 利润表.投资净收益 利润表.其中:对联营公司的投资收益 利润表.公允价值变动净收益 利润表.其他业务收入 利润表.二、营业支出 利润表.营业税金及附加 利润表.业务及管理费用 利润表.研发费用 利润表.资产减值损失 利润表.其他业务支出 利润表.三、营业利润 利润表.加:营业外收入 利润表.减:营业外支出 利润表.四、利润总额 利润表.减:所得税 利润表.五、净利润 利润表.归属于母公司的净利润 利润表.少数股东权益 利润表.六、每股收益 利润表.基本每股收益(元/股) 利润表.稀释每股收益(元/股) 利润表.七、其他综合收益 利润表.八、综合收益总额 利润表.归属于母公司所有者的综合收益总额 利润表.归属于少数股东的综合收益总额 |
| Data.data.现金流量表 | array | 现金流量表.报表日期 现金流量表.单位 现金流量表.一、经营活动产生的现金流量 现金流量表.客户存款和同业存放款项净增加额 现金流量表.向央行借款净增加额 现金流量表.向其他金融机构拆入资金净增加额 现金流量表.收取利息、手续费及佣金的现金 现金流量表.收到其他与经营活动有关的现金 现金流量表.经营活动现金流入小计 现金流量表.客户贷款及垫款净增加额 现金流量表.存放中央银行和同业款项净增加额 现金流量表.支付给职工以及为职工支付的现金 现金流量表.支付的各项税费 现金流量表.支付其他与经营活动有关的现金 现金流量表.支付利息、手续费及佣金的现金 现金流量表.经营活动现金流出小计 现金流量表.经营活动产生的现金流量净额 现金流量表.二、投资活动产生的现金流量 现金流量表.收回投资收到的现金 现金流量表.取得投资收益收到的现金 现金流量表.处置固定资产、无形资产及其他资产而收到的现金 现金流量表.取得子公司及其他营业单位所收到的现金净额 现金流量表.收到其他与投资活动有关的现金 现金流量表.投资活动现金流入小计 现金流量表.投资支付的现金 现金流量表.购建固定资产、无形资产和其他长期资产支付的现金 现金流量表.支付的其他与投资活动有关的现金 现金流量表.投资活动现金流出小计 现金流量表.投资活动产生的现金流量净额 现金流量表.三、筹资活动产生的现金流量 现金流量表.吸收投资所收到的现金 现金流量表.发行证券化资产所吸收的现金 现金流量表.发行债券收到的现金 现金流量表.增加股本所收到的现金 现金流量表.收到其他与筹资活动有关的现金 现金流量表.筹资活动现金流入小计 现金流量表.偿还债务所支付的现金 现金流量表.分配股利、利润或偿付利息支付的现金 现金流量表.其中:偿付利息所支付的现金 现金流量表.支付新股发行费用 现金流量表.支付其他与筹资活动有关的现金 现金流量表.筹资活动现金流出小计 现金流量表.筹资活动产生的现金流量净额 现金流量表.四、汇率变动对现金及现金等价物的影响 现金流量表.五、现金及现金等价物净增加额 现金流量表.加:期初现金及现金等价物余额 现金流量表.六、期末现金及现金等价物余额 现金流量表.附注 现金流量表.净利润 现金流量表.加:少数股东收益 现金流量表.计提的资产减值准备 现金流量表.其中：计提的坏账准备 现金流量表.计提的贷款损失准备 现金流量表.冲回存放同业减值准备 现金流量表.固定资产折旧、油气资产折耗、生产性生物资产折旧 现金流量表.投资性房地产折旧 现金流量表.无形资产、递延资产及其他资产的摊销 现金流量表.其中:无形资产摊销 现金流量表.长期待摊费用摊销 现金流量表.长期资产摊销 现金流量表.处置固定资产、无形资产和其他长期产的损失/(收益) 现金流量表.处置投资性房地产的损失/(收益) 现金流量表.固定资产报废损失 现金流量表.财务费用 现金流量表.投资损失(减:收益) 现金流量表.公允价值变动(收益)/损失 现金流量表.汇兑损益 现金流量表.衍生金融工具交易净损益 现金流量表.折现回拔(减值资产利息冲转) 现金流量表.存货的减少 现金流量表.贷款的减少 现金流量表.存款的增加 现金流量表.拆借款项的净增 现金流量表.金融性资产的减少 现金流量表.预计负债的增加 现金流量表.收到已核销款项 现金流量表.递延所得税资产的减少 现金流量表.递延所得税负债的增加 现金流量表.经营性应收项目的增加 现金流量表.经营性应付项目的增加 现金流量表.经营性其他资产的减少 现金流量表.经营性其他负债的增加 现金流量表.其他 现金流量表.经营活动现金流量净额 现金流量表.以固定资产偿还债务 现金流量表.以投资偿还债务 现金流量表.以固定资产进行投资 现金流量表.债务转为资本 现金流量表.一年内到期的可转换公司债券 现金流量表.融资租入固定资产 现金流量表.其他不涉及现金收支的投资和筹资活动金额 现金流量表.现金的期末余额 现金流量表.减:现金的期初余额 现金流量表.现金等价物的期末余额 现金流量表.减：现金等价物的期初余额 现金流量表.现金及现金等价物净增加额 |
## 接口常见 HTTP 响应状态码
> 以下为接口调用中常见的 HTTP 传输层状态码，不等同于响应体内的业务状态码；完整状态码注册表以 IANA HTTP Status Code Registry 为准。
| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 请求成功 | HTTP 请求已成功处理；业务状态请结合响应体中的自定义业务码判断。 |
| 201 | 资源已创建 | 创建类接口请求成功，并已生成对应资源。 |
| 202 | 请求已接受 | 请求已被接受处理，结果可能异步完成。 |
| 204 | 无响应内容 | 请求成功但响应体为空，适用于无需返回数据的操作。 |
| 304 | 资源未变更 | 配合缓存或条件请求使用，表示可继续使用本地缓存。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 认证失败 | 缺少、无效或未通过认证的访问凭证（如 AppKey）。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 408 | 请求超时 | 客户端请求在服务端等待时间内未完成，可稍后重试。 |
| 409 | 请求冲突 | 请求与当前资源状态冲突，调整参数或业务状态后重试。 |
| 413 | 请求内容过大 | 上传文件或请求体超过接口限制。 |
| 414 | 请求地址过长 | 请求 URL 超过服务端可处理长度，建议减少查询参数或改用 POST。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 422 | 请求语义错误 | 请求格式正确，但参数取值、语义或业务约束无法处理。 |
| 429 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 431 | 请求头过大 | 请求头字段过大或过多，建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 网关或上游错误 | 网关或代理从上游服务收到异常响应。 |
| 503 | 服务暂时不可用 | 服务维护、容量保护或依赖异常导致暂时不可用，请稍后重试。 |
| 504 | 网关超时 | 网关等待上游服务响应超时，可稍后重试或降低请求复杂度。 |
## 接口自定义业务状态码
| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 正常返回 | |
| 101 | 参数错误 | |
| 102 | 请求频率受限 | 默认按来源 IP 限速，单 IP 最多 5 QPS，可满足常规业务调用。超出限制时接口会返回 429 请求频率受限；已购买接口订单可加购 10 QPS 扩展。 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
## cURL 请求示例
```bash
curl --location --request GET 'https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type='
```
## 常见问题 Q&A
### Q: 数据请求有缓存吗？
A: 接口默认以实时响应为目标。对于日更、月更等具备明确更新周期的数据，会在数据周期内采用缓存与预热策略，以提升响应速度和稳定性；实时查询类接口则以接口说明中的更新频率为准。建议业务侧结合数据时效要求设置本地缓存与重试策略，避免高频重复请求。
### Q: 如何保证请求时 AppKey 的安全性？
A: 用户可以登录咕咕数据开发者中心，在 `APP KEY 管理` 页面复制对应产品的 AppKey；未开通接口时先进入当前接口的购买开通页，已开通或到期续费时进入开发者中心或订单与续费页。建议将 AppKey 保存在服务端环境中，由后端统一调用 API，再向前端或业务系统返回必要结果。不要把 AppKey 写入网页、App 客户端或公开仓库；生产环境建议按系统或业务线拆分 AppKey，并保留调用日志，便于权限控制、审计与问题排查。
### Q: 接口可以用于哪些开发语言？
A: 只要支持 HTTPS 请求的语言和框架均可接入，包括 Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等。推荐由后端统一封装调用逻辑，集中处理鉴权、缓存、限流、重试和错误码映射，让 Web、App、AI Agent、内部系统和自动化任务复用同一套数据能力。
### Q: 接口性能可以保证吗？
A: GuGuData API 按生产环境标准部署，持续关注接口稳定性、响应速度与可用性。实际响应时间会受接口类型、请求参数、数据源更新和网络环境影响；建议生产接入前进行联调与压测，并设置合理的超时、重试、降级和告警策略。批量处理或高并发场景可提前评估 QPS、白名单和专属容量方案。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7