
Level 1 行情和市场深度有什么区别?买卖价、数量与盘口档位解析
了解 Level 1 行情与市场深度的区别,掌握买卖价、盘口数量和档位的含义,并根据实际业务选择合适的实时行情 API。
开发实时行情页面时,很多人最初只需要显示一只股票的最新价格。后来产品增加了买一、卖一、买卖数量,甚至要求展示五档、十档盘口,才发现原来接入的行情数据并不能满足所有需求。
这里涉及两个经常被混淆的概念:Level 1 行情和市场深度(Market Depth)。
它们都与买卖报价有关,但展示的信息并不相同。Level 1 关注最优买卖报价,市场深度则进一步展示不同价格档位上的买卖挂单情况。理解两者的区别,才能判断实时行情 API 应该提供哪些字段,以及前端究竟需要展示多少档盘口数据。
Level 1 行情主要看什么?
Level 1 行情通常指市场最优报价,也就是当前最高买价(Best Bid)和最低卖价(Best Ask),以及对应的买卖数量。
例如,某只股票当前的报价如下:
| 行情字段 | 价格 | 数量 |
|---|---|---|
| 买一(Best Bid) | 100.00 | 1,200 |
| 卖一(Best Ask) | 100.05 | 900 |
买一表示当前买方愿意接受的最高价格,卖一表示卖方愿意接受的最低价格。两者之间的差额就是买卖价差(Bid-Ask Spread)。
在这个例子中,价差为 0.05。
对于实时行情页面来说,这些信息通常已经足够展示当前最优买卖报价、买卖方向和价差。用户不需要查看所有挂单,也能快速了解当前市场的报价情况。
需要注意的是,最新成交价不等于买一价或卖一价。最新成交价反映最近一次已经发生的交易,而买一和卖一反映当前订单簿中的最优报价。两者可能相同,也可能存在差异。
另外,Level 1 的具体字段定义会因数据供应商而异。有些数据源还会提供最新成交价、成交量等信息。因此,接入 API 时不能只看 Level 1 这个名称,还需要检查实际返回的数据结构。
市场深度比 Level 1 多了哪些信息?
如果 Level 1 只展示买一和卖一,那么市场深度就会进一步展示买二、买三以及更高档位的买卖报价。
例如,下面是一组假设的盘口数据:
| 买盘档位 | 买入价格 | 买入数量 | 卖盘档位 | 卖出价格 | 卖出数量 |
|---|---|---|---|---|---|
| 买一 / 卖一 | 100.00 | 1,200 | 卖一 | 100.05 | 900 |
| 买二 / 卖二 | 99.95 | 2,400 | 卖二 | 100.10 | 1,500 |
| 买三 / 卖三 | 99.90 | 1,800 | 卖三 | 100.15 | 2,100 |
从这组数据可以看到,Level 1 只需要读取买卖盘第一档,而市场深度能够继续展示其他价格档位及其对应数量。
这对开发订单簿(Order Book)页面尤其重要。
例如,用户看到买一数量为 1,200,并不代表其他价格位置没有买盘。继续查看买二和买三,才能了解更低价格区间的挂单分布。
不过,市场深度也不意味着能够看到市场上的每一笔委托。常见的多档盘口数据是按照价格档位展示汇总数量,并不等同于逐笔委托明细(Level 3)。
还有一个容易混淆的地方:盘口数量和成交量不是同一个字段。盘口数量表示某个价格档位对应的买卖挂单量,成交量则反映已经发生的交易。开发时不能把盘口数量直接当成累计成交量使用。
接入实时行情 API 时,应该选择哪一种?
主要取决于产品需要展示什么。
如果你正在开发一个普通的股票报价卡片,只需要展示最新成交价、买一、卖一和价差,那么 Level 1 通常就能满足需求。
如果你开发的是交易终端、盘口监控页面或量化分析工具,需要观察多个价格档位的挂单分布,就需要接入市场深度数据。
以 AllTick 为例,其 WebSocket 深度订阅接口通过 bids 和 asks 返回买卖盘口,并使用 price 和 volume 表示对应价格和数量。开发者可以根据实际返回的数组,分别构建 Level 1 报价视图和多档订单簿。
例如,订阅港股腾讯控股 700.HK 的五档盘口,可以使用以下订阅消息:
{
"cmd_id": 22002,
"seq_id": 123,
"trace": "depth-700-hk",
"data": {
"symbol_list": [
{
"code": "700.HK",
"depth_level": 5
}
]
}
}收到深度推送后,可以根据返回的数组结构提取最优买卖价,或者直接渲染全部可用档位:
function parseOrderBook(data) {
const normalize = (levels) => {
return (Array.isArray(levels) ? levels : []).map(
(item, index) => ({
level: index + 1,
price: item.price ?? null,
quantity: item.volume ?? null
})
);
};
const bids = normalize(data.bids);
const asks = normalize(data.asks);
return {
bestBid: bids[0] ?? null,
bestAsk: asks[0] ?? null,
bids,
asks
};
}这里有一个值得注意的细节:不要在前端直接假设每只产品都有五档或十档数据。AllTick 的接口允许通过 depth_level 指定订阅深度;如果不传该字段,默认只返回一档。如果请求的档位超过实际可用深度,则返回实际能够提供的档位。
目前官方文档列出的最大深度也因市场而异:
| 市场类型 | 最大盘口深度 |
|---|---|
| 港股 | 10 档 |
| 沪深 A 股 | 5 档 |
| 加密货币 | 5 档 |
| 美股 | 1 档 |
| 外汇、贵金属、原油 | 1 档 |
因此,即使程序请求五档数据,也不代表所有市场都会返回五档。官方文档还特别说明,部分 CFD 指数不提供 volume 字段,跨市场开发时应允许数量字段为空。
对于持续更新的行情页面,使用 WebSocket 接收深度推送,通常比反复发送 HTTP 请求更适合。若页面还需要展示最新成交价,则应另外接入对应的 Tick 数据,不能直接用买一或卖一代替最新成交价。
选择行情数据时,不要只看档位数量
Level 1 和市场深度解决的是不同层次的信息需求。
Level 1 让用户快速了解最优买卖报价,市场深度则让用户进一步观察不同价格位置的挂单情况。对于只需要价格展示的应用,接入多档订单簿可能增加不必要的数据处理;对于需要盘口分析的应用,只获取 Level 1 又可能无法满足产品需求。
开发之前,最好先确定页面需要展示的字段、盘口档位,以及目标市场实际支持的深度,再选择对应的 API。
AllTick 同时提供 REST 和 WebSocket 行情数据接口。对于需要持续接收买卖盘变化的应用,可以参考其 WebSocket 深度订阅文档,了解订阅协议、depth_level 参数和返回字段;也可以查看 AllTick API 官方文档,根据具体业务选择适合的行情接入方式。