AllTick
-
Level 1行情订单簿 市场数据实时市场数据市场深度

Level 1 行情和市场深度有什么区别?买卖价、数量与盘口档位解析

了解 Level 1 行情与市场深度的区别,掌握买卖价、盘口数量和档位的含义,并根据实际业务选择合适的实时行情 API。

AllTick阅读 5 分钟

开发实时行情页面时,很多人最初只需要显示一只股票的最新价格。后来产品增加了买一、卖一、买卖数量,甚至要求展示五档、十档盘口,才发现原来接入的行情数据并不能满足所有需求。

这里涉及两个经常被混淆的概念:Level 1 行情和市场深度(Market Depth)。

它们都与买卖报价有关,但展示的信息并不相同。Level 1 关注最优买卖报价,市场深度则进一步展示不同价格档位上的买卖挂单情况。理解两者的区别,才能判断实时行情 API 应该提供哪些字段,以及前端究竟需要展示多少档盘口数据。

Level 1 行情主要看什么?

Level 1 行情通常指市场最优报价,也就是当前最高买价(Best Bid)和最低卖价(Best Ask),以及对应的买卖数量。

例如,某只股票当前的报价如下:

行情字段价格数量
买一(Best Bid)100.001,200
卖一(Best Ask)100.05900

买一表示当前买方愿意接受的最高价格,卖一表示卖方愿意接受的最低价格。两者之间的差额就是买卖价差(Bid-Ask Spread)。

在这个例子中,价差为 0.05。

对于实时行情页面来说,这些信息通常已经足够展示当前最优买卖报价、买卖方向和价差。用户不需要查看所有挂单,也能快速了解当前市场的报价情况。

需要注意的是,最新成交价不等于买一价或卖一价。最新成交价反映最近一次已经发生的交易,而买一和卖一反映当前订单簿中的最优报价。两者可能相同,也可能存在差异。

另外,Level 1 的具体字段定义会因数据供应商而异。有些数据源还会提供最新成交价、成交量等信息。因此,接入 API 时不能只看 Level 1 这个名称,还需要检查实际返回的数据结构。

市场深度比 Level 1 多了哪些信息?

如果 Level 1 只展示买一和卖一,那么市场深度就会进一步展示买二、买三以及更高档位的买卖报价。

例如,下面是一组假设的盘口数据:

买盘档位买入价格买入数量卖盘档位卖出价格卖出数量
买一 / 卖一100.001,200卖一100.05900
买二 / 卖二99.952,400卖二100.101,500
买三 / 卖三99.901,800卖三100.152,100

从这组数据可以看到,Level 1 只需要读取买卖盘第一档,而市场深度能够继续展示其他价格档位及其对应数量。

这对开发订单簿(Order Book)页面尤其重要。

例如,用户看到买一数量为 1,200,并不代表其他价格位置没有买盘。继续查看买二和买三,才能了解更低价格区间的挂单分布。

不过,市场深度也不意味着能够看到市场上的每一笔委托。常见的多档盘口数据是按照价格档位展示汇总数量,并不等同于逐笔委托明细(Level 3)。

还有一个容易混淆的地方:盘口数量和成交量不是同一个字段。盘口数量表示某个价格档位对应的买卖挂单量,成交量则反映已经发生的交易。开发时不能把盘口数量直接当成累计成交量使用。

接入实时行情 API 时,应该选择哪一种?

主要取决于产品需要展示什么。

如果你正在开发一个普通的股票报价卡片,只需要展示最新成交价、买一、卖一和价差,那么 Level 1 通常就能满足需求。

如果你开发的是交易终端、盘口监控页面或量化分析工具,需要观察多个价格档位的挂单分布,就需要接入市场深度数据。

以 AllTick 为例,其 WebSocket 深度订阅接口通过 bids 和 asks 返回买卖盘口,并使用 price 和 volume 表示对应价格和数量。开发者可以根据实际返回的数组,分别构建 Level 1 报价视图和多档订单簿。

例如,订阅港股腾讯控股 700.HK 的五档盘口,可以使用以下订阅消息:

text
{
  "cmd_id": 22002,
  "seq_id": 123,
  "trace": "depth-700-hk",
  "data": {
    "symbol_list": [
      {
        "code": "700.HK",
        "depth_level": 5
      }
    ]
  }
}

收到深度推送后,可以根据返回的数组结构提取最优买卖价,或者直接渲染全部可用档位:

text
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 官方文档,根据具体业务选择适合的行情接入方式。

立即开始接入市场数据

几秒内生成免费 API 密钥,通过一个端点连接所有市场。