请求单个（多个）符号实时K线

获取指定交易所中一个或多个符号的最新 K 线数据。

该接口返回请求时的最新 K 线快照，不会持续推送。需要持续接收动态 K 线时，应使用 WebSocket。

接口信息

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

请求参数

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

请求格式：

/mini_lists?market={market}&symbol={symbol}&interval={interval}

K 线周期

interval	周期
1min	1 分钟
5min	5 分钟
10min	10 分钟
15min	15 分钟
30min	30 分钟
1h	1 小时
1day	1 日
1week	1 周
1month	1 月

interval 必须使用表中支持的实际参数，并保持原有大小写。

多符号规则

• 同一次请求只能指定一个交易所。
• 请求中的全部符号应属于 market 指定的交易所。
• 多个符号使用英文逗号分隔。
• 符号代码应使用产品列表接口返回的原始值。
• 单次请求最多提交 20 个符号。
• 查询不同交易所的符号时，应按照交易所分别发送请求。

返回结构

字段	类型	说明
State	integer	业务状态
Code	integer/string	业务代码
Msg	string	状态说明
data	array	符号及 K 线数据

符号数据

字段	类型	允许为空	说明
data[].market	string	否	符号所属交易所代码
data[].code	string	否	符号代码
data[].data	string	是	K 线数据

K 线数据格式

data[].data 当前使用字符串保存多根 K 线：

• 不同 K 线之间使用英文分号 ; 分隔；
• 同一根 K 线中的字段使用英文逗号 , 分隔；
• 返回数据按照最新时间在前排列；
• 每个符号最多返回最近 30 根 K 线。

每根 K 线的字段顺序为：

位置	字段	类型	说明
1	时间	integer	Unix 秒级时间戳
2	收盘价	number/string	当前周期收盘价或最新价
3	开盘价	number/string	当前周期开盘价
4	最高价	number/string	当前周期最高价
5	最低价	number/string	当前周期最低价
6	成交额	number/string/null	当前周期成交额
7	成交量	number/string/null	当前周期成交量

客户端必须按照固定位置解析字段，并在转换数值前处理空字符串和 null。

接口行为

• 返回结果为符号数组。
• 每个符号最多返回最近 30 根 K 线。
• K 线按照最新时间在前排列。
• 返回顺序不保证与请求中的符号顺序一致。
• 客户端应使用交易所代码和符号代码匹配数据。
• 不同交易所的价格精度和成交量单位可能不同。
• 当前周期尚未结束时，最后一根 K 线的数据可能继续变化。

空数据

某个符号返回空数据可能表示：

• 符号代码无效；
• 符号不属于指定交易所；
• 账号没有相应权限；
• interval 不受支持；
• 当前周期没有 K 线；
• 市场当前没有交易数据。

客户端应逐项检查每个符号的返回结果。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 market	补充交易所参数
缺少 symbol	补充符号参数
缺少 interval	补充 K 线周期
交易所代码无效	参考 3.7 核对交易所代码
符号与交易所不匹配	通过产品列表确认所属交易所
周期不支持	使用文档列出的 interval
符号数量超过限制	拆分为多个请求

不支持的周期当前可能返回成功状态和空数据。因此，客户端应在发送请求前验证 interval。

使用限制

• 一次请求只能指定一个交易所和一个 K 线周期。
• 单次请求最多提交 20 个符号。
• 每个符号最多返回最近 30 根 K 线。
• 需要更多历史数据时，应使用“请求历史 K 线与分页”接口。
• 需要持续接收动态 K 线时，应使用 WebSocket。