请求单个/多个符号完整行情

获取指定交易所中一个或多个符号的完整行情数据。

接口信息

项目	内容
接口路径	/mini_prices
请求方法	GET
鉴权	需要
返回格式	JSON

请求参数

参数	位置	类型	必填	实际参数	说明
market	Query	string	是	交易所代码，参考 3.7	符号所属交易所
symbol	Query	string	是	AAPL 或 AAPL,TSLA	一个或多个符号代码，多个符号使用英文逗号分隔

请求格式：

/mini_prices?market={market}&symbol={symbol}

多符号规则

• 同一次请求只能指定一个交易所。
• 请求中的全部符号应属于 market 指定的交易所。
• 多个符号使用英文逗号分隔。
• 符号代码应使用产品列表接口返回的原始值。
• 符号代码应保持原有大小写。
• 单次请求最多提交 20 个符号。
• 客户端应对符号去重，并删除空值。

查询不同交易所的符号时，应按照交易所分别发送请求。

返回结构

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

行情数据

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

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

字段名称区分大小写，客户端必须按照接口实际返回字段读取。

接口行为

• 返回结果为数组。
• 返回顺序不保证与请求中的符号顺序一致。
• 客户端应使用交易所代码和符号代码匹配数据。
• 不同交易所的字段和值类型可能存在差异。
• 数值可能返回为 JSON 数字、数字字符串、空字符串或 null。
• 客户端应逐项确认请求的符号是否出现在返回结果中。

空数据

返回空数组或缺少某个符号的数据，可能表示：

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

空数组不能直接解释为符号不存在。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 market	补充交易所参数
缺少 symbol	补充符号参数
交易所代码无效	参考 3.7 核对交易所代码
符号与交易所不匹配	通过产品列表确认所属交易所
返回数据不完整	逐项核对请求符号和返回符号
符号数量超过限制	拆分为多个请求

HTTP 状态码为 200 不一定表示业务成功，客户端还需要检查业务状态和返回数据。

使用限制

• 一次请求只能查询一个交易所。
• 单次请求最多提交 20 个符号。
• 服务端当前可能不会主动拒绝超过限制的请求，但客户端仍应遵守 20 个符号的限制。
• 需要持续接收实时行情时，应使用 WebSocket 产品订阅。
• 需要获取交易所全部产品行情时，应使用“请求全市场报价”接口。