请求单个符号实时/历史 K 线

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

page=1 返回最新一页 K 线，后续页用于查询更早的历史数据。该接口返回查询时的数据快照，不会持续推送。

接口信息

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

请求参数

参数	位置	类型	必填	实际参数	默认值	说明
market	Query	string	是	交易所代码，参考 3.7	无	符号所属交易所
symbol	Query	string	是	符号代码	无	只能传入一个符号
interval	Query	string	是	K 线周期	无	指定 K 线周期
page	Query	integer	否	大于或等于 1	1	历史数据页码

请求格式：

/mini_list?market={market}&symbol={symbol}&interval={interval}&page={page}

K 线周期

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

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

分页规则

page	返回范围
1	最新一页 K 线
2	第 1 页之前的历史 K 线
3 及以上	更早的历史 K 线

每页最多返回约 300 根 K 线。

实时行情仍在写入时，分页边界可能发生变化，相邻页面之间可能出现重复数据。客户端合并多页数据时，应根据交易所、符号、周期和 K 线时间去重。

返回结构

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

K 线数据格式

K 线当前使用字符串格式返回：

• 不同 K 线之间使用英文分号 ; 分隔；
• 同一根 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。

实时 K 线

使用 page=1 可以获取当前最新的 K 线快照。

当前周期尚未结束时，最新一根 K 线的收盘价、最高价、最低价、成交额和成交量可能继续变化。

如果需要持续更新，可以定期请求第 1 页，但必须遵守调用频率限制。需要推送式更新时，应使用 WebSocket 动态 K 线。

历史 K 线

查询历史数据时，从 page=1 开始逐页请求，直到：

• 返回空数据；
• 返回数量少于正常页大小；
• 已到达所需的历史时间；
• 达到账号允许的查询范围。

客户端应使用 K 线时间去重，不应只依赖页码判断数据位置。

空数据

返回空数据可能表示：

• 符号代码无效；
• 符号不属于指定交易所；
• 账号没有相应权限；
• K 线周期不受支持；
• 页码超过可用历史范围；
• 当前没有对应周期的数据。

客户端应同时检查业务状态、请求参数和账号权限。

错误处理

情况	客户端处理
未传或错误的访问密钥	检查鉴权信息
缺少 market	补充交易所参数
缺少 symbol	补充符号参数
缺少 interval	补充 K 线周期
交易所代码无效	参考 3.7 核对交易所代码
符号与交易所不匹配	通过产品列表确认所属交易所
周期不支持	使用文档列出的 interval
页码小于 1 或不是整数	修正为有效整数

当前服务可能将无效页码按照默认页处理，而不是返回参数错误。客户端应在发送请求前验证 page。

使用限制

• 一次请求只能查询一个符号。
• 每次请求只能指定一个 K 线周期。
• 每页最多返回约 500 根 K 线。
• 高频获取最新 K 线时，应遵守账号调用额度。
• 批量获取多个符号的最新 K 线时，应使用“请求单个（多个）符号实时 K 线”接口。
• 持续接收动态 K 线时，应使用 WebSocket。