AllTick
-
股票市场数据股票api实时行情金融数据 api

WebSocket 行情推送收到数据后如何判断这条消息属于哪只股票?

多只股票同时订阅时,WebSocket 收到的行情数据如何判断属于哪只股票?本文介绍如何通过消息类型和股票代码建立可靠的数据映射。

AllTick阅读 5 分钟

开发股票行情页面时,WebSocket 真正接入以后,很多人很快会遇到一个问题:同一个连接订阅了多只股票,服务器不断推送数据,但程序怎么知道当前这一条行情到底属于哪只股票?

例如,一个行情页面同时订阅了腾讯控股 700.HK、阿里巴巴 9988.HK 和美股 AAPL.US。连接建立后,服务器可能连续推送多条 Tick 数据。如果程序只是拿到 JSON 后直接读取价格并更新页面,就很容易出现“价格更新了,但更新到了错误股票”的问题。

这个问题的关键其实不在 WebSocket 本身,而在于行情消息里的标识字段和本地股票状态之间如何建立对应关系。

不要用“消息顺序”判断股票

最容易出现的误区,是认为自己订阅股票时是按照某个顺序发送的,所以收到数据后也可以按照这个顺序对应。

例如:

text
700.HK
9988.HK
AAPL.US

于是程序看到第一条推送就认为它属于 700.HK,第二条属于 9988.HK。

这种做法并不可靠。

WebSocket 是持续的数据流,服务器推送的是当前产生的行情消息,不应该依赖“第几条消息”来判断股票。不同股票的成交时间、推送频率都可能不同,某一只股票可能连续收到多条数据,另一只股票则暂时没有新的成交。

真正应该依赖的是消息本身携带的股票代码。

以 AllTick 的股票 WebSocket 为例,订阅最新成交价使用 22004,服务器推送实时成交数据时使用 22998。推送数据中的 code 字段就是识别具体产品的重要依据。

例如收到这样的消息:

text
{
  "cmd_id": 22998,
  "data": {
    "code": "700.HK",
    "seq": "1605509068000001",
    "tick_time": "1605509068",
    "price": "651.12",
    "volume": "300",
    "turnover": "12345.6",
    "trade_direction": 1
  }
}

程序首先读取:

text
data.code

得到 700.HK,再根据这个代码找到对应的股票状态,最后更新价格、成交量等字段。

所以判断一条 WebSocket 行情属于哪只股票,最核心的逻辑可以概括成:

-
-

多只股票一起订阅时,最好维护一个代码映射

实际开发中,我更建议在程序内部提前建立一个“股票代码 → 行情状态”的映射。

比如页面订阅了:

text
{
  "symbol_list": [
    {"code": "700.HK"},
    {"code": "9988.HK"},
    {"code": "AAPL.US"}
  ]
}

收到推送后,不需要判断它是第几条消息,而是直接拿 code 查找。

JavaScript 中可以这样处理:

text
const stocks = new Map([
  ["700.HK", { name: "Tencent", price: null, volume: null }],
  ["9988.HK", { name: "Alibaba", price: null, volume: null }],
  ["AAPL.US", { name: "Apple", price: null, volume: null }]
]);

function handleMessage(rawMessage) {
  const message = JSON.parse(rawMessage);

  // 只处理最新成交价推送
  if (message.cmd_id !== 22998) {
    return;
  }

  const quote = message.data;
  const code = quote.code;

  const stock = stocks.get(code);

  // 未订阅或未知代码,直接忽略
  if (!stock) {
    return;
  }

  stock.price = Number(quote.price);
  stock.volume = Number(quote.volume);

  console.log(`${code}: ${stock.price}`);
}

这里有一个细节很重要:不要把 code 当成展示名称使用。

700.HK 是程序识别行情的代码,而页面上可能希望显示“腾讯控股”。因此可以把两者分开保存:

text
const stocks = new Map([
  ["700.HK", {
    symbol: "700.HK",
    name: "Tencent",
    price: null
  }],
  ["AAPL.US", {
    symbol: "AAPL.US",
    name: "Apple",
    price: null
  }]
]);

这样收到 700.HK 的数据时,程序知道应该更新哪个对象,前端再决定显示什么名称。

cmd_id 和 code 解决的是两个不同的问题

解析 WebSocket 数据时,还需要注意不要把协议号和股票代码混为一谈。

cmd_id 更适合判断“这是什么类型的消息”,而 code 用来判断“这条行情属于谁”。

以 AllTick 当前 WebSocket 协议为例,股票实时成交订阅使用 22004,对应的服务器行情推送使用 22998;订单簿订阅则使用 22002,服务器推送使用 22999。

因此,如果一个页面同时处理 Tick 和 Order Book,程序可以先根据 cmd_id 分流,再根据 data.code 找到具体股票:

text
if (message.cmd_id === 22998) {
  // Tick / 最新成交数据
  handleTrade(message.data);
}

if (message.cmd_id === 22999) {
  // Order Book / 订单簿数据
  handleOrderBook(message.data);
}

这种处理方式比“看到 price 就更新股票”安全得多。因为一个真实的行情系统往往不只有一种消息类型,后面还可能加入盘口、交易状态等数据。

股票代码本身也要和订阅时保持一致

另一个容易被忽略的问题,是代码格式。

不同市场的股票代码并不一定只是一个数字。例如 AllTick 的代码体系中,港股可以使用 700.HK,美股可以使用 AAPL.US,A 股则使用带市场后缀的代码。接入前需要确认代码存在于对应的产品列表中。

因此,程序内部最好不要擅自把代码转换成另一种格式。

例如:

text
订阅:700.HK
推送:700.HK
Map:700.HK

这三处保持一致,后续处理会非常简单。

如果开发者自己维护了一套股票名称、交易所和代码映射表,也应该把它作为独立的数据层,而不是在每次收到 WebSocket 消息时临时拼接股票名称。

对于需要同时接收多只股票实时行情的场景,AllTick 提供专门的股票 WebSocket 连接,并支持在一次订阅请求中提交多个股票代码。这时,应用层按照推送消息中的 code 建立路由,是比较自然的处理方式。

如果正在开发实时行情看板、股票监控系统或者量化数据接入服务,建议先把“消息类型识别 → 股票代码识别 → 行情状态更新”这三层逻辑拆开。这样即使后面从几只股票扩展到几百只股票,也不需要重新设计消息处理方式。

AllTick 的官方 WebSocket 文档提供了股票实时成交和订单簿订阅的协议说明,可以进一步核对具体字段和消息结构。

立即开始接入市场数据

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