A 股实时行情数据

所有A股实时交易行情数据

GET /stock/cn/realtime

业务说明

不传股票代码时可查询 A 股全市场行情，适合为市场总览页面获取多只股票的当前数据。

传入单只股票代码即可查看该股票的行情指标，便于详情页或个股观察任务按需查询。

支持用逗号分隔多个股票代码，一次返回自选股或关注列表中的多只股票数据。

返回最新价、开盘价、昨收价及当日最高和最低价，便于展示当日价格区间与变化。

提供涨跌额、涨跌幅和振幅，可用于行情看板中的价格变化展示与条件筛选。

提供成交量和成交额，帮助观察股票当日的交易规模。

提供量比和换手率，可将交易活跃度与价格变化放在同一页面观察。

返回动态市盈率和市净率，便于在行情展示中同时提供基础估值指标。

返回当前是否涨停的标识，方便在自选股列表中突出显示相关股票。

结果包含股票代码、名称和各项数值指标，适合接入行情看板、投研工具与自动化数据任务。

可与股票代码、交易日历、资金流及财务数据接口组合，支持从行情观察延伸到进一步研究。

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

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY
symbol	query	string	否	无	默认不传递或传递空值，则获取所有 A 股实时交易数据（需要注意在获取全量数据时，数据量传输对接口调用性能的影响）。支持传递单支或多支 A 股股票代码进行筛选，多支股票用逗号隔开，格式为: 600031,688819。具体值参见 A 股股票代码参数枚举页面

独立请求示例

{
  "symbol": "600031,600000"
}

返回契约

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"
        },
        "StatusDescription": {
          "type": "string"
        },
        "ResponseDateTime": {
          "type": "string"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次实际返回的记录或动态表格行数。"
        }
      }
    },
    "Data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "Symbol",
          "StockName",
          "Latest",
          "ChangePercent",
          "ChangeAmount",
          "TradingVolume",
          "TradingAmount",
          "Swing",
          "High",
          "Low",
          "Open",
          "PreClose",
          "QuantityRatio",
          "TurnoverRate",
          "PERatioDynamic",
          "PBRatio",
          "IsLimitUp"
        ],
        "properties": {
          "Symbol": {
            "type": "string",
            "description": "A 股股票代码"
          },
          "StockName": {
            "type": "string",
            "description": "股票名称"
          },
          "Latest": {
            "type": "number",
            "description": "最新价，单位：元"
          },
          "ChangePercent": {
            "type": "number",
            "description": "涨跌幅，单位：%"
          },
          "ChangeAmount": {
            "type": "number",
            "description": "涨跌额，单位：元"
          },
          "TradingVolume": {
            "type": "number",
            "description": "成交量，单位：手"
          },
          "TradingAmount": {
            "type": "number",
            "description": "成交额，单位：元"
          },
          "Swing": {
            "type": "number",
            "description": "振幅，单位：%"
          },
          "High": {
            "type": "number",
            "description": "最高，单位：元"
          },
          "Low": {
            "type": "number",
            "description": "最低，单位：元"
          },
          "Open": {
            "type": "number",
            "description": "今日开盘价，单位：元"
          },
          "PreClose": {
            "type": "number",
            "description": "昨收价，单位：元"
          },
          "QuantityRatio": {
            "type": "number",
            "description": "量比"
          },
          "TurnoverRate": {
            "type": "number",
            "description": "换手率，单位：%"
          },
          "PERatioDynamic": {
            "type": "number",
            "description": "市盈率-动态"
          },
          "PBRatio": {
            "type": "number",
            "description": "市净率"
          },
          "IsLimitUp": {
            "type": "boolean",
            "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"
        },
        "StatusDescription": {
          "type": "string"
        },
        "ResponseDateTime": {
          "type": "string"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次实际返回的记录或动态表格行数。"
        }
      }
    },
    "Data": {
      "type": "null"
    }
  }
}

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"
        },
        "StatusDescription": {
          "type": "string"
        },
        "ResponseDateTime": {
          "type": "string"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次实际返回的记录或动态表格行数。"
        }
      }
    },
    "Data": {
      "type": "null"
    }
  }
}

业务状态与 HTTP 状态

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

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

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=600000","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 15:27:00.693","DataTotalCount":1},"Data":[{"Symbol":"600000","StockName":"浦发银行","Latest":10.06,"ChangePercent":0.4,"ChangeAmount":0.04,"TradingVolume":1164223,"TradingAmount":1177122567,"Swing":2.89,"High":10.22,"Low":9.93,"Open":9.98,"PreClose":10.02,"QuantityRatio":1.59,"TurnoverRate":0.35,"PERatioDynamic":6.19,"PBRatio":0.44,"IsLimitUp":false}]}

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

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

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

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

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

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

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

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

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

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

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态