• API 功能

    • 支持所有公募开放式基金指标数据查询;
    • 实时数据,支持一次查询多个基金数据;
    • 最多支持 7 大指标数据查询;
    • 包含货币型基金历史数据查询;
    • 多数据源清洗整合,百万级数据毫秒级返回;
    • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡。
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/fund/open/history

    返回格式: application/json; charset=utf-8

    请求方式: GET

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY

    数据预览: https://www.gugudata.com/preview/fundopenhistory

    接口测试:  https://api.gugudata.com/fund/open/history/demo

    OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

    前置接口

    前置接口说明: 查询公募开放式基金代码列表数据,支持分页查询

    前置接口地址: https://api.gugudata.com/fund/fundsymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE

    前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 20 条

    前置接口返回格式: application/json; charset=utf-8

    前置接口返回说明: 包含基金代码 FundCode、基金简称 FundShort、基金类型 FundType、拼音全称 FundPinYin、拼音缩写 FundABBR

    前置接口请求方式: GET

    前置接口请求协议: HTTPS

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

    参数名 参数类型 是否必须 默认值 备注
    appkey string YOUR_APPKEY 付费后获取的 APPKEY
    symbol string YOUR_VALUE 基金代码,如 007401,可传递多个基金代码(货币型基金不支持传递多个),使用英文逗号隔开,格式为 007401,952099。基金代码具体值参见 公募基金代码参数枚举页面
    type string YOUR_APPKEY 基金指标,可选值,传递参数值为括号中的值:单位净值走势(NAVTREND), 累计净值走势(ACCUMULATEDNETWORTHTREND), 累计收益率走势(ACCUMULATEDRATEOFRETURN), 同类排名走势(SIMILARRANKINGS), 同类排名百分比(SIMILARRANKINGSPERCENT), 分红送配详情(DIVIDENDDETAILS), 拆分详情(SPLITDETAILS)。货币型基金传递:MONETARY

    返回参数

    参数名 参数类型 备注
    DataStatus.StatusCode integer 接口返回状态码
    DataStatus.StatusDescription string 接口返回状态说明
    DataStatus.ResponseDateTime string 接口数据返回时间
    DataStatus.DataTotalCount integer 此条件下的总数据量,一般用于分页计算
    Data.FundCode string 基金代码
    Data.FundShort string 基金简称
    Data.FundType string 基金类型
    Data.FundOpenNAVTrend.DateKey integer 单位净值走势 日期,格式为 20210101
    Data.FundOpenNAVTrend.NetAssetValue number 单位净值走势 单位净值
    Data.FundOpenNAVTrend.DayGrowthRate number 单位净值走势 日增长率 注意单位: %
    Data.FundOpenAccumulatedNetWorthTrend.DateKey integer 累计净值走势 日期,格式为 20210101
    Data.FundOpenAccumulatedNetWorthTrend.AccumulatedNetWorth number 累计净值走势 累计净值
    Data.FundOpenAccumulatedRateofReturn.DateKey integer 累计收益率走势 日期,格式为 20210101
    Data.FundOpenAccumulatedRateofReturn.AccumulatedRateofReturn number 累计收益率走势 累计收益率 注意单位: %
    Data.FundOpenAccumulatedRateofReturn.DateKey integer 累计收益率走势 日期,格式为 20210101
    Data.FundOpenAccumulatedRateofReturn.AccumulatedRateofReturn number 累计收益率走势 累计收益率 注意单位: %
    Data.FundOpenSimilarRankings.DateKey integer 同类排名走势 日期,格式为 20210101
    Data.FundOpenSimilarRankings.SimilarRanking integer 同类排名走势 同类型排名-每日近三月排名
    Data.FundOpenSimilarRankings.TotalRanking integer 同类排名走势 总排名-每日近三月排名
    Data.FundOpenSimilarRankingsPercent.DateKey integer 同类排名百分比 日期,格式为 20210101
    Data.FundOpenSimilarRankingsPercent.SimilarRankingPercent number 同类排名百分比 同类型排名-每日近3月收益排名百分比
    Data.FundOpenDividendDetails.Year string 分红送配详情 年份
    Data.FundOpenDividendDetails.RightsRegistrationDay string 分红送配详情 权益登记日
    Data.FundOpenDividendDetails.ExDividendDate string 分红送配详情 除息日
    Data.FundOpenDividendDetails.PerShare string 分红送配详情 每份分红
    Data.FundOpenDividendDetails.ShareDividendDate string 分红送配详情 分红发放日
    Data.FundOpenSplitDetails.Year string 拆分详情 年份
    Data.FundOpenSplitDetails.SplitDate string 拆分详情 权益登记日
    Data.FundOpenSplitDetails.SplitType string 拆分详情 除息日
    Data.FundOpenSplitDetails.SplitRatio string 拆分详情 每份分红
    Data.PerTenThousandIncome string 每万份收益(货币型基金)
    Data.SevenDayAnnualizedIncome number 7日年化收益率(货币型基金)
    Data.PurchaseStatus string 申购状态(货币型基金)
    Data.RedemptionStatus string 赎回状态(货币型基金)
  • 接口 HTTP 响应标准状态码

    状态码 状态码解释 备注
    200 接口正常响应 请求成功,业务状态请结合响应体中的自定义业务码判断。
    400 请求参数错误 请求参数缺失、格式错误或参数组合不合法。
    401 鉴权失败 缺少 appkey 或 appkey 无效。
    403 无权限访问 订单到期、权限不足或接口额度不可用。
    404 资源不存在 请求路径不存在。
    405 请求方法不允许 当前路径不支持该 HTTP 方法。
    415 请求内容类型不支持 上传或请求体的内容类型不符合接口要求。
    429 请求频率受限 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5),我们不限制同一个 key 的请求总次数,但当单位时间内同一个 IP 请求次数过多,或 AI CDN 判定为恶意抓取数据、流量攻击等异常时,CDN 会返回此状态码,请适当降低请求频率。如有特殊大并发请求场景需求,可联系我们添加白名单处理。
    500 服务内部错误 服务端处理异常,请稍后重试。
    502 上游依赖错误 上游依赖服务不可用或返回异常。
  • 接口自定义状态码

    自定义状态码 自定义状态码解释 备注
    100 正常返回
    101 参数错误
    102 请求频率受限 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5),我们不限制同一个 key 的请求总次数,但当单位时间内同一个 IP 请求次数过多,或 AI CDN 判定为恶意抓取数据、流量攻击等异常时,CDN 会返回此状态码,请适当降低请求频率。如有特殊大并发请求场景需求,可联系我们添加白名单处理。
    103 账号欠费
    104 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值
    110 接口响应错误
  • 请求示例代码
    curl --location --request GET 'https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY'
    #include <curl/curl.h>
    
    int main(void) {
      CURL *curl = curl_easy_init();
      if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY");
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        CURLcode res = curl_easy_perform(curl);
        (void)res;
        curl_easy_cleanup(curl);
      }
      return 0;
    }
    
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Net.Http;
    
    var client = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Get, "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY");
    var response = client.SendAsync(request).Result;
    Console.WriteLine(response.Content.ReadAsStringAsync().Result);
    
    package main
    
    import (
      "fmt"
      "io"
      "net/http"
    )
    
    func main() {
      url := "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY"
      req, err := http.NewRequest("GET", url, nil)
      if err != nil {
        fmt.Println(err)
        return
      }
      res, err := http.DefaultClient.Do(req)
      if err != nil {
        fmt.Println(err)
        return
      }
      defer res.Body.Close()
      body, err := io.ReadAll(res.Body)
      if err != nil {
        fmt.Println(err)
        return
      }
      fmt.Println(string(body))
    }
    
    OkHttpClient client = new OkHttpClient().newBuilder().build();
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY")
      .method("GET", null)
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
    
    $.ajax({
      url: "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY",
      method: "GET",
    }).done(function (response) {
      console.log(response);
    });
    
    const response = await fetch("https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY", {
      method: "GET"
    });
    console.log(await response.text());
    
    const response = await fetch("https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY", {
      method: "GET"
    });
    console.log(await response.text());
    
    #import <Foundation/Foundation.h>
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY"]];
    [request setHTTPMethod:@"GET"];
    NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
        return;
      }
      NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];
    [task resume];
    
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_CUSTOMREQUEST => "GET",
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
    
    import requests
    
    url = "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY"
    response = requests.request("GET", url)
    print(response.text)
    
    require "uri"
    require "net/http"
    
    url = URI("https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY")
    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
    
    let semaphore = DispatchSemaphore(value: 0)
    var request = URLRequest(url: URL(string: "https://api.gugudata.com/fund/open/history?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=YOUR_APPKEY")!, timeoutInterval: .infinity)
    request.httpMethod = "GET"
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      defer { semaphore.signal() }
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
    }
    task.resume()
    semaphore.wait()
    
  • 常见问题 Q&A

    • Q: 数据请求有缓存吗?

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

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

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

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

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

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

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

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

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

  • 技术支持

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

业务相关接口推荐

开放式基金净值历史数据
  • 历史净值数据
  • 历史数据 / 多维度指数参数
  • 2999元/年限时折扣 1499元/年
查看详情 数据校验更新于 4 小时前
50% 折扣
场内交易基金历史数据
  • 多维数据查询指标
  • 场内基金数据 / 全量历史数据
  • 1199元/年限时折扣 399元/年
查看详情 数据校验更新于 6 小时前
30% 折扣
开放式基金净值估算数据
  • 全量基金数据
  • 实时数据 / 所有基金数据
  • 2999元/年限时折扣 1499元/年
查看详情 被调用于 1 秒前
50% 折扣
开放式场内交易基金排行
  • 多维度参数返回
  • 实时数据 / 返回多维度指数
  • 1499元/年限时折扣 499元/年
查看详情 被调用于 5 秒前
30% 折扣