基金基本信息

分页获取基金代码、名称、类型与拼音。

接口标识：fundinfolist

请求方法：GET

接口路径：/fund/basicinfo

官网文档：https://www.gugudata.com/api/details/fundinfolist

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

API 功能

分页返回基金代码、简称、全称、基金类型和名称拼音等基础目录信息。

可作为基金搜索框、选择器、代码校验和其他基金接口参数准备的数据源。

DataTotalCount 表示当前基金目录的全部记录数，不是当前页实际返回条数。

pageIndex 从 1 开始，pageSize 每页最多返回 20 条记录。

结果按基金代码整理，同一基金代码只保留一条有效基础信息记录。

基金代码始终按字符串返回并保留前导零，接入方不应转换为整数。

当外部基础目录暂时不可用时，服务会使用可用的基金元数据保证目录稳定性。

本接口不返回净值、价格、收益率或申赎状态，行情数据应使用对应基金接口。

请求参数

appkey（string，必填，默认：YOUR_APPKEY）：必填。接口调用凭证，请在咕咕数据控制台获取；用于身份鉴权和套餐额度校验，不要在公开页面或客户端日志中暴露

pageIndex（integer，可选，默认：1）：可选。分页页码，从 1 开始；第一页传 1，第二页传 2，以此类推

pageSize（integer，可选，默认：10）：可选。每页返回条数，取值范围为 1~20；未传时默认 10

返回参数

DataStatus.RequestParameter（string，必返）：服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息

DataStatus.StatusCode（integer，必返）：业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断

DataStatus.StatusDescription（string，必返）：业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题

DataStatus.ResponseDateTime（string，必返）：服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff

DataStatus.DataTotalCount（integer，必返）：当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数

Data.FundCode（string，必返）：基金的 6 位代码，保留前导零，可作为其他基金接口的 symbol 参数

Data.FundShort（string，必返）：基金简称，适合在空间有限的列表或选择器中展示

Data.FundName（string，必返）：基金完整名称，用于基金详情和精确检索展示

Data.FundType（string，必返）：基金所属类型，例如股票型、混合型、债券型或指数型等

Data.FundPinYin（string，必返）：基金名称对应的拼音检索值，可用于拼音或首字母搜索

响应约定

HTTP 200 表示服务已返回结构化响应，业务结果仍应以 DataStatus.StatusCode 为准。

DataStatus.StatusCode=100 表示正常返回；其他值请结合 StatusDescription 处理。

接口标识、URL、HTTP 方法、参数键和响应字段保持兼容；本次仅完善名称和说明。

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "RequestParameter": "string",
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0
    },
    "Data": {
        "FundCode": "string",
        "FundShort": "string",
        "FundName": "string",
        "FundType": "string",
        "FundPinYin": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

基金基本信息

基金基本信息#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

基金基本信息

API 功能

请求参数

返回参数

响应约定