• API 功能
    • 支持所有 A 股全量三大财报数据查询;
    • 分别包括资产负债表、利润表、现金流量表数据;
    • 返回 70 多项财务指标;
    • 多数据源清洗整合,百万级数据毫秒级返回;
    • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡。
    • 接口调用状态与状态监控
  • 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://www.gugudata.com/preview/cnannualreport

    接口测试: https://api.gugudata.com/stock/cn/annualreport/demo

    前置接口

    前置接口说明: 查询 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

    请求参数(GET 请求方式可参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string YOUR_APPKEY 付费后获取的 APPKEY
    symbol string YOUR_VALUE 传递单支股票代码,如: 600031。可通过前置接口或参见 A 股股票代码参数枚举页面
    type string 三大财报类型,可选值为:资产负债表|利润表|现金流量表

    返回参数

    参数名 参数类型 备注
    DataStatus.StatusCode int 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount int 此条件下的总数据量,一般用于分页计算
    Data.columns string[] 财报的数据列名称,注意因为财报数据字段非常多且为了保证表达精准性,这里的字段说明以中文进行表达。
    Data.data string[][] 对应时间点的具体财报数据
    Data.data.资产负债表 string[] 资产负债表.报表日期
    资产负债表.单位
    资产负债表.资产
    资产负债表.现金及存放中央银行款项
    资产负债表.存放同业款项
    资产负债表.拆出资金
    资产负债表.贵金属
    资产负债表.交易性金融资产
    资产负债表.衍生金融工具资产
    资产负债表.买入返售金融资产
    资产负债表.应收利息
    资产负债表.发放贷款及垫款
    资产负债表.代理业务资产
    资产负债表.可供出售金融资产
    资产负债表.持有至到期投资
    资产负债表.长期股权投资
    资产负债表.应收投资款项
    资产负债表.固定资产合计
    资产负债表.无形资产
    资产负债表.商誉
    资产负债表.递延税款借项
    资产负债表.投资性房地产
    资产负债表.其他资产
    资产负债表.资产总计
    资产负债表.负债
    资产负债表.向中央银行借款
    资产负债表.同业存入及拆入
    资产负债表.其中:同业存放款项
    资产负债表.拆入资金
    资产负债表.衍生金融工具负债
    资产负债表.交易性金融负债
    资产负债表.卖出回购金融资产款
    资产负债表.客户存款(吸收存款)
    资产负债表.应付职工薪酬
    资产负债表.应交税费
    资产负债表.应付利息
    资产负债表.应付账款
    资产负债表.代理业务负债
    资产负债表.应付债券
    资产负债表.递延所得税负债
    资产负债表.预计负债
    资产负债表.其他负债
    资产负债表.负债合计
    资产负债表.所有者权益
    资产负债表.股本
    资产负债表.其他权益工具
    资产负债表.其中:优先股
    资产负债表.资本公积
    资产负债表.减:库藏股
    资产负债表.其他综合收益
    资产负债表.盈余公积
    资产负债表.未分配利润
    资产负债表.一般风险准备
    资产负债表.外币报表折算差额
    资产负债表.其他储备
    资产负债表.归属于母公司股东的权益
    资产负债表.少数股东权益
    资产负债表.股东权益合计
    资产负债表.负债及股东权益总计
    Data.data.利润表 string[] 利润表.报表日期
    利润表.单位
    利润表.一、营业收入
    利润表.利息净收入
    利润表.其中:利息收入
    利润表.减:利息支出
    利润表.手续费及佣金净收入
    利润表.其中:手续费及佣金收入
    利润表.减:手续费及佣金支出
    利润表.汇兑收益
    利润表.投资净收益
    利润表.其中:对联营公司的投资收益
    利润表.公允价值变动净收益
    利润表.其他业务收入
    利润表.二、营业支出
    利润表.营业税金及附加
    利润表.业务及管理费用
    利润表.研发费用
    利润表.资产减值损失
    利润表.其他业务支出
    利润表.三、营业利润
    利润表.加:营业外收入
    利润表.减:营业外支出
    利润表.四、利润总额
    利润表.减:所得税
    利润表.五、净利润
    利润表.归属于母公司的净利润
    利润表.少数股东权益
    利润表.六、每股收益
    利润表.基本每股收益(元/股)
    利润表.稀释每股收益(元/股)
    利润表.七、其他综合收益
    利润表.八、综合收益总额
    利润表.归属于母公司所有者的综合收益总额
    利润表.归属于少数股东的综合收益总额
    Data.data.现金流量表 string[] 现金流量表.报表日期
    现金流量表.单位
    现金流量表.一、经营活动产生的现金流量
    现金流量表.客户存款和同业存放款项净增加额
    现金流量表.向央行借款净增加额
    现金流量表.向其他金融机构拆入资金净增加额
    现金流量表.收取利息、手续费及佣金的现金
    现金流量表.收到其他与经营活动有关的现金
    现金流量表.经营活动现金流入小计
    现金流量表.客户贷款及垫款净增加额
    现金流量表.存放中央银行和同业款项净增加额
    现金流量表.支付给职工以及为职工支付的现金
    现金流量表.支付的各项税费
    现金流量表.支付其他与经营活动有关的现金
    现金流量表.支付利息、手续费及佣金的现金
    现金流量表.经营活动现金流出小计
    现金流量表.经营活动产生的现金流量净额
    现金流量表.二、投资活动产生的现金流量
    现金流量表.收回投资收到的现金
    现金流量表.取得投资收益收到的现金
    现金流量表.处置固定资产、无形资产及其他资产而收到的现金
    现金流量表.取得子公司及其他营业单位所收到的现金净额
    现金流量表.收到其他与投资活动有关的现金
    现金流量表.投资活动现金流入小计
    现金流量表.投资支付的现金
    现金流量表.购建固定资产、无形资产和其他长期资产支付的现金
    现金流量表.支付的其他与投资活动有关的现金
    现金流量表.投资活动现金流出小计
    现金流量表.投资活动产生的现金流量净额
    现金流量表.三、筹资活动产生的现金流量
    现金流量表.吸收投资所收到的现金
    现金流量表.发行证券化资产所吸收的现金
    现金流量表.发行债券收到的现金
    现金流量表.增加股本所收到的现金
    现金流量表.收到其他与筹资活动有关的现金
    现金流量表.筹资活动现金流入小计
    现金流量表.偿还债务所支付的现金
    现金流量表.分配股利、利润或偿付利息支付的现金
    现金流量表.其中:偿付利息所支付的现金
    现金流量表.支付新股发行费用
    现金流量表.支付其他与筹资活动有关的现金
    现金流量表.筹资活动现金流出小计
    现金流量表.筹资活动产生的现金流量净额
    现金流量表.四、汇率变动对现金及现金等价物的影响
    现金流量表.五、现金及现金等价物净增加额
    现金流量表.加:期初现金及现金等价物余额
    现金流量表.六、期末现金及现金等价物余额
    现金流量表.附注
    现金流量表.净利润
    现金流量表.加:少数股东收益
    现金流量表.计提的资产减值准备
    现金流量表.其中:计提的坏账准备
    现金流量表.计提的贷款损失准备
    现金流量表.冲回存放同业减值准备
    现金流量表.固定资产折旧、油气资产折耗、生产性生物资产折旧
    现金流量表.投资性房地产折旧
    现金流量表.无形资产、递延资产及其他资产的摊销
    现金流量表.其中:无形资产摊销
    现金流量表.长期待摊费用摊销
    现金流量表.长期资产摊销
    现金流量表.处置固定资产、无形资产和其他长期产的损失/(收益)
    现金流量表.处置投资性房地产的损失/(收益)
    现金流量表.固定资产报废损失
    现金流量表.财务费用
    现金流量表.投资损失(减:收益)
    现金流量表.公允价值变动(收益)/损失
    现金流量表.汇兑损益
    现金流量表.衍生金融工具交易净损益
    现金流量表.折现回拔(减值资产利息冲转)
    现金流量表.存货的减少
    现金流量表.贷款的减少
    现金流量表.存款的增加
    现金流量表.拆借款项的净增
    现金流量表.金融性资产的减少
    现金流量表.预计负债的增加
    现金流量表.收到已核销款项
    现金流量表.递延所得税资产的减少
    现金流量表.递延所得税负债的增加
    现金流量表.经营性应收项目的增加
    现金流量表.经营性应付项目的增加
    现金流量表.经营性其他资产的减少
    现金流量表.经营性其他负债的增加
    现金流量表.其他
    现金流量表.经营活动现金流量净额
    现金流量表.以固定资产偿还债务
    现金流量表.以投资偿还债务
    现金流量表.以固定资产进行投资
    现金流量表.债务转为资本
    现金流量表.一年内到期的可转换公司债券
    现金流量表.融资租入固定资产
    现金流量表.其他不涉及现金收支的投资和筹资活动金额
    现金流量表.现金的期末余额
    现金流量表.减:现金的期初余额
    现金流量表.现金等价物的期末余额
    现金流量表.减:现金等价物的期初余额
    现金流量表.现金及现金等价物净增加额
  • 接口 HTTP 响应标准状态码
    状态码 状态码解释 备注
    200 接口正常响应 业务状态码参见下方 接口自定义状态码
    403 / 429 请求频率超限 CDN 层通过 IP 请求频率智能判断,一般不同 IP 高频请求不会触发此状态码。
  • 接口自定义状态码
    自定义状态码 自定义状态码解释 备注
    100 正常返回 可通过判断此状态码断言接口正常返回。
    -1 请求失败 请求处理请求失败。
    501 参数错误 请检查您传递的参数个数以及参数类型是否匹配。
    429 / 502 请求频率受限 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5),我们不限制同一个 key 的请求总次数,但当单位时间内同一个 IP 请求次数过多,或 AI CDN 判定为恶意抓取数据、流量攻击等异常时,CDN 会返回此状态码,请适当降低请求频率。如有特殊大并发请求场景需求,可联系我们添加白名单处理。
    503 APPKEY 权限超限/订单到期 请至开发者中心检查您的 APPKEY 是否到期或是否权限超限。
    504 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值。
    505 请求的次数超出接口限制 请检查对应接口是否有请求次数限制以及您目前的接口请求剩余次数。
    900 接口内部响应错误 接口可用性为 99.999%,如获取到此状态码请邮件联系我们。
  • 请求示例代码
    curl --location --request GET 'https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type='
    CURL *curl;
    CURLcode res;
    curl = curl_easy_init();
    if(curl) {
      curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
      curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=");
      curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
      curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
      struct curl_slist *headers = NULL;
      curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
      res = curl_easy_perform(curl);
    }
    curl_easy_cleanup(curl);
    var requestOptions = {
      method: 'GET',
      redirect: 'follow'
    };
    fetch("https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=", requestOptions)
      .then(response => response.text())
      .then(result => console.log(result))
      .catch(error => console.log('error', error));
    var client = new RestClient("https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=");
    client.Timeout = -1;
    var request = new RestRequest(Method.GET);
    IRestResponse response = client.Execute(request);
    Console.WriteLine(response.Content);
    package main
    import (
      "fmt"
      "net/http"
      "io/ioutil"
    )
    func main() {
      url := "https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type="
      method := "GET"
      client := &http.Client {
      }
      req, err := http.NewRequest(method, url, nil)
      if err != nil {
        fmt.Println(err)
      }
      res, err := client.Do(req)
      defer res.Body.Close()
      body, err := ioutil.ReadAll(res.Body)
      fmt.Println(string(body))
    }
    OkHttpClient client = new OkHttpClient().newBuilder()
      .build();
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=")
      .method("GET", null)
      .build();
    Response response = client.newCall(request).execute();
    var settings = {
      "url": "https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=",
      "method": "GET",
      "timeout": 0,
    };
    $.ajax(settings).done(function (response) {
      console.log(response);
    });
    #import <Foundation/Foundation.h>
    dispatch_semaphore_t sema = dispatch_semaphore_create(0);
    NSMutableURLRequest *request =
            [NSMutableURLRequest requestWithURL:[NSURL URLWithString:
            @"https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type="]
      cachePolicy:NSURLRequestUseProtocolCachePolicy
      timeoutInterval:10.0];
    [request setHTTPMethod:@"GET"];
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
      } else {
        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
        NSError *parseError = nil;
        NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];
        NSLog(@"%@",responseDictionary);
        dispatch_semaphore_signal(sema);
      }
    }];
    [dataTask resume];
    dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
    import requests
    url = "https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type="
    payload = {}
    headers= {}
    response = requests.request("GET", url, headers=headers, data = payload)
    print(response.text)
    require "uri"
    require "net/http"
    url = URI("https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=")
    https = Net::HTTP.new(url.host, url.port);
    https.use_ssl = true
    request = Net::HTTP::Get.new(url)
    response = https.request(request)
    puts response.read_body
    import Foundation
    var semaphore = DispatchSemaphore (value: 0)
    var request = URLRequest(url: URL(string:"https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=")!,timeoutInterval: Double.infinity)
    request.httpMethod = "GET"
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
      semaphore.signal()
    }
    task.resume()
    semaphore.wait()
    /*
     * GuGuData API Request Node.js Demo
     * 咕咕数据 API Node.js 请求 DEMO
     * 咕咕数据,专业的数据提供商,提供全面的数据接口 API,并提供专业全面的数据接口、商业数据分析。
     * 让数据成为您的生产原料。
     * https://www.gugudata.com
     */
    
    /* 咕咕数据 API 请求 DEMO ***开始***/
    // 导入相关类库
    var request = require("request");
    var querystring = require("querystring");
    var api_host = "https://api.gugudata.com";
    var api_path = "/stock/cn/annualreport"; // todo: 注意修改请求对应的 API 接口
    // todo: 注意修改构造请求参数
    var data = {
     appkey:'YOUR_APPKEY', symbol:'YOUR_VALUE', type:''
    };
    var content = querystring.stringify(data);
    var options = {
        method: "GET",
        url: api_host + api_path + "?" + content,
        headers: {}
    };
    // 发送网络请求
    var requestGuGuData = request(options, (error, response) => {
        if (error) throw new Error(error);
        console.log("********接口响应返回 JSON 数据********");
        console.log(JSON.parse(response.body));
        requestGuGuData.end();
        console.log("********接口响应结束********");
    });
    /* 咕咕数据 API 请求 DEMO ***结束***/
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 0,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "GET",
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
  • 常见问题 Q&A
    • Q: 数据请求有缓存吗?

      A: 我们为所有数据请求提供实时响应。对于定期更新的数据,我们在其更新周期内实施缓存策略,以优化性能。

    • Q: 如何保证请求时 key 的安全性?

      A: 我们建议将对 API 的请求操作放置在您的应用程序后端。这样,前端请求只与您的后端服务交互,确保了更高的安全性和易于维护的架构。

    • Q: 接口可以用于哪些开发语言?

      A: 我们的接口支持所有能进行网络请求的开发语言,便于在各类项目中快速整合数据。

    • Q: 接口的性能可以保证吗?

      A: 我们的接口后台使用与商业级项目相同的架构,保证了稳定且高效的性能。您可以通过访问测试接口了解更多性能信息。

  • 服务协议以及服务免责声明

    用户应当充分阅读 服务协议 以及 服务免责声明 ,用户购买与使用咕咕数据 API 服务亦视为接受本协议。

  • 技术支持
    • 技术支持邮箱: support@gugudata.com
    • 微信客服: 客服链接

业务相关接口推荐

稳定提供服务 10 年 A 股业绩报表数据
  • A 股上市公司季度业绩报表数据
  • 全量数据 / 业绩报表
  • 2999元/年限时折扣 1499元/年
查看详情 数据更新于 1 小时前
50% 折扣
稳定提供服务 10 年 A 股涨停板实时数据
  • 所有A股涨停板实时数据
  • A股涨停数据 / 实时数据
  • 2999元/年限时折扣 999元/年
查看详情 被调用于 3 秒前
30% 折扣
A 股买卖盘口数据
  • 不同价格级别买卖数量和报价
  • 股票交易数据 / 盘口分析
  • 2999元/年限时折扣 1499元/年
查看详情 被调用于 6 秒前
50% 折扣
A 股个股资金流
  • 全量股票资金流数据
  • 全量A股数据 / 最长30日历史数据
  • 3999元/年限时折扣 1999元/年
查看详情 被调用于 3 秒前
50% 折扣