POST已开放finance-a-shares-price

A股报价

调用价格

5 匠币/次

在线调试

无需写代码，浏览器中直接发起真实请求

接入文档

接口简介

本接口提供中国大陆A股市场（含上海、深圳、北京证券交易所）的实时报价数据。开发者可通过传入股票代码，获取包括最新价、涨跌幅、成交量、成交额以及买卖五档盘口在内的详细行情信息。数据覆盖全面，适用于需要实时监控股市动态的应用场景。

适用场景

金融资讯应用：为股票交易软件、财经新闻门户提供实时股价展示。
量化分析系统：作为基础数据源，用于策略回测或实时信号触发。
企业监控看板：上市公司或投资机构内部用于监控持仓股票或关注标的的市场表现。
个人投资助手：集成于微信小程序或App中，为用户提供便捷的个股查询服务。

请求与返回说明

请求方式：POST 请求参数：

symbol (必填, string)：品种代码，支持多个代码以英文逗号分隔。格式需包含交易所前缀，如 sz000002 (深市), sh600000 (沪市), bj430047 (北交所)。

返回结果：

code：业务状态码，200表示成功。
data：核心数据对象，键名为股票代码，值为该股票的详情对象，包含：
name：股票名称
price：实时价格
change / changeRate：涨跌额与涨跌率
high / low：今日最高/最低价
volume / value：成交量与成交额
bid1_vol ~ bid5_vol / ask1_vol ~ ask5_vol：买一至买五、卖一至卖五的量
bid1 ~ / ~ ：买一至买五、卖一至卖五的价格

接入建议

代码格式规范：务必确保传入的 symbol 包含正确的交易所前缀（sh/sz/bj），否则可能导致查询失败或数据错误。
批量查询优化：接口支持逗号分隔的多只股票查询，建议将同一页面的多只股票合并为一次请求，以减少网络开销并提高加载速度。
缓存策略：虽然提供实时数据，但考虑到前端展示频率，建议在非高频交易场景下设置秒级缓存，避免过度频繁调用。
异常处理：请始终检查返回的 code 字段，仅当 code 为 200 时解析 data 内容，并妥善处理网络超时或服务不可用的情况。

接入示例代码

提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。

请求示例

{
  "symbol": "品种代码，以英文逗号分割，如：sz000002,bj430047"
}

响应示例

{
  "msg": "成功",
  "code": 200,
  "taskNo": "202960247220113090298671",
  "data": {
    "sh688193": {
      "name": "仁度生物",
      "bid1_vol": "3850",
      "high": "28.670",
      "update_time": 1713336733,
      "low": "26.710",
      "price": "27.910",
      "ask1_vol": "454",
      "bid2_vol": "700",
      "changeRate": "4.6887",
      "ask5_vol": "600",
      "value": "8457252.000",
      "bid4_vol": "40",
      "change": "1.2500",
      "bid3_vol": "1400",
      "ask2_vol": "843",
      "volume": "303488",
      "bid5_vol": "1400",
      "ask4_vol": "2064",
      "ask5": "28.160",
      "ask2": "28.010",
      "ask1": "28.000",
      "bid5": "27.780",
      "ask4": "28.130",
      "ask3": "28.020",
      "ask": "28.000",
      "bid3": "27.840",
      "bid4": "27.830",
      "bid1": "27.900",
      "bid2": "27.850",
      "preclose": "26.660",
      "bid": "27.900",
      "open": "26.880",
      "ask3_vol": "1400"
    }
  }
}

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
type	string	object
properties	object	{...}
properties.symbol	object	{...}
properties.symbol.type	string	string
properties.symbol.description	string	品种代码，以英文逗号分割，如：sz000002,bj430047
required	array	"symbol"
required[]	string	symbol

响应字段