请求全市场报价

获取指定交易所全部可用产品的最新行情报价。

接口信息

项目	内容
接口路径	/prices
请求方法	GET
鉴权	需要
返回格式	JSON
分页	不支持

请求参数

参数	位置	类型	必填	实际参数	说明
market	Query	string	是	交易所代码，参考 3.7	指定需要获取全市场报价的交易所

请求格式：

/prices?market={market}

market 必须使用系统支持的交易所代码，并保持原有大小写。

返回结构

字段	类型	说明
State	integer	业务状态
Code	integer/string	业务代码
Msg	string	状态说明
data	array	行情报价列表

报价数据

字段	类型	允许为空	说明
data[].market	string	否	产品所属交易所代码
data[].code	string	否	产品代码
data[].data	object	否	产品行情数据

data[].data 中包含价格、涨跌、成交量、成交额、盘口和时间等行情字段，详细定义参考“1.1行情字段”。

接口行为

• 一次请求只能获取一个交易所的全市场报价。
• 接口返回账号有权限访问的产品行情。
• 接口不支持分页。
• 返回顺序不固定，不能依赖数组位置识别产品。
• 客户端应使用交易所代码和产品代码匹配数据。
• 不同产品的可用行情字段可能不同。
• 没有有效值的字段可能返回空字符串或 null。

空数据

返回空数组可能表示：

• 交易所代码无效；
• 账号没有该交易所的数据权限；
• 当前交易所没有可用行情；
• 服务端暂时没有数据。

客户端应同时检查业务状态、交易所代码和账号权限。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 market	补充必填参数
交易所代码无效	参考 3.7 核对交易所代码
返回空数组	检查交易所代码、账号权限及市场状态
响应数据量过大	增加读取超时，并优先使用指定产品行情接口

HTTP 状态码为 200 不一定表示业务成功，客户端还需要检查响应中的业务状态字段。

使用限制

全市场报价可能返回大量数据，不建议高频调用有频率限制。

如果只需要少量产品，应使用“请求指定产品报价”接口。实时行情场景应优先使用 WebSocket 订阅。