A 股股票列表

实时更新的股票代码列表

GET /stock/symbols

业务说明

目前支持所有 A 股股票代码列表查询；

无需自己维护数据源，我们提供实时列表数据；

包含 A 股所有交易所的股票代码列表；

毫秒级查询性能；

围绕“A 股股票代码”提供标准化能力，便于快速接入现有业务；

适合将“A 股股票代码”结果接入业务系统、后台工具和自动化流程；

适合行情看板、投研系统和自动化数据任务接入；

可与股票代码、交易日历、资金流和财务数据接口组合；

鉴权：需要 AppKey，使用本操作声明的鉴权位置。

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY
stockType	query	string	是	无	股票类型，A：A股
pageIndex	query	integer	否	1	分页参数，页码
pageSize	query	integer	否	0	分页参数，每页条数，最大值：100，若传递 0 则返回所有数据

独立请求示例

{
  "stockType": "A",
  "pageIndex": 1,
  "pageSize": 20
}

返回契约

HTTP 200：业务码 100 成功。
application/json

{
  "type": "object",
  "required": [
    "DataStatus",
    "Data"
  ],
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "Symbol",
          "StockName",
          "StockType"
        ],
        "additionalProperties": false,
        "properties": {
          "Symbol": {
            "type": "string",
            "description": "股票代码"
          },
          "StockName": {
            "type": "string",
            "description": "股票名称。"
          },
          "StockType": {
            "type": "string",
            "description": "股票类型标记 A。"
          }
        },
        "description": "股票代码对象数组；同一快照按既有来源顺序分页。"
      },
      "description": "股票代码对象数组；同一快照按既有来源顺序分页。"
    }
  }
}

HTTP 401：公共鉴权失败；沿用现有公共契约。

HTTP 403：公共权益或额度不足；沿用现有公共契约。

HTTP 404：资源不存在。请求路径不存在。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 405：请求方法不允许。当前路径不支持该 HTTP 方法。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 415：请求内容类型不支持。上传或请求体的内容类型不符合接口要求。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 429：公共频率限制；沿用现有公共契约。

HTTP 502：上游依赖错误。上游依赖服务不可用或返回异常。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "股票代码对象数组；同一快照按既有来源顺序分页。"
    }
  }
}

HTTP 503：业务码 901：处理、依赖失败或超时。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "股票代码对象数组；同一快照按既有来源顺序分页。"
    }
  }
}

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/stocksymbols
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"stockType=A\u0026pageIndex=2\u0026pageSize=20","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 15:27:05.423","DataTotalCount":5577},"Data":[{"Symbol":"000031","StockName":"大悦城","StockType":"A"},{"Symbol":"000032","StockName":"深桑达Ａ","StockType":"A"},{"Symbol":"000034","StockName":"神州数码","StockType":"A"},{"Symbol":"000035","StockName":"中国天楹","StockType":"A"},{"Symbol":"000036","StockName":"华联控股","StockType":"A"},{"Symbol":"000037","StockName":"深南电A","StockType":"A"},{"Symbol":"000039","StockName":"中集集团","StockType":"A"},{"Symbol":"000042","StockName":"中洲控股","StockType":"A"},{"Symbol":"000045","StockName":"深纺织Ａ","StockType":"A"},{"Symbol":"000048","StockName":"京基智农","StockType":"A"},{"Symbol":"000049","StockName":"德赛电池","StockType":"A"},{"Symbol":"000050","StockName":"深天马Ａ","StockType":"A"},{"Symbol":"000055","StockName":"方大集团","StockType":"A"},{"Symbol":"000056","StockName":"*ST皇庭","StockType":"A"},{"Symbol":"000058","StockName":"深 赛 格","StockType":"A"},{"Symbol":"000059","StockName":"华锦股份","StockType":"A"},{"Symbol":"000060","StockName":"中金岭南","StockType":"A"},{"Symbol":"000061","StockName":"农 产 品","StockType":"A"},{"Symbol":"000062","StockName":"深圳华强","StockType":"A"},{"Symbol":"000063","StockName":"中兴通讯","StockType":"A"}]}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503业务码 901：处理、依赖失败或超时。

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态