AllTick
-
株式 api株式市場データ金融データ apiリアルタイム相場

WebSocketのリアルタイム行情配信を受信した後、このメッセージがどの銘柄のものかをどう判断する?

複数銘柄を同時に購読する場合、WebSocketで受信した株価データがどの銘柄のものかを、メッセージ種別と銘柄コードから判別する方法を解説します。

AllTick読了 5 分

株式のリアルタイム行情ページを開発していると、WebSocketを実際に接続した後に、ある問題にすぐ気づくことがあります。1つの接続で複数の銘柄を購読している場合、サーバーから次々に送られてくるメッセージが、いったいどの銘柄の行情なのかをプログラムはどう判断すればよいのでしょうか。

例えば、ある行情画面でTencent 700.HK、Alibaba 9988.HK、米国株の AAPL.US を同時に購読しているとします。接続が確立されると、サーバーから複数のTickデータが連続して送信されることがあります。JSONを受信するたびに価格だけを読み取って画面を更新していると、「価格は更新されたものの、別の銘柄に反映されてしまった」という問題が起こりやすくなります。

この問題のポイントは、WebSocketそのものではありません。重要なのは、行情メッセージに含まれる識別フィールドと、アプリケーション側で管理している銘柄の状態をどのように対応付けるかです。

「メッセージの順番」で銘柄を判断しない

最もありがちな誤りは、銘柄を購読するときにある順番で送信したので、受信したデータも同じ順番で対応すると考えてしまうことです。

例えば:

text
700.HK
9988.HK
AAPL.US

という順番で購読したからといって、最初に届いたメッセージを 700.HK、2番目を 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}`);
}

ここで重要な点が1つあります。code を画面上の銘柄名として使わないことです。

700.HK はプログラムが行情を識別するためのコードです。一方、画面では「Tencent」などの名称を表示したい場合があります。そのため、両者を分けて管理できます。

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 が使用されます。Order Bookの購読には 22002、サーバーからの配信には 22999 が使用されます。

そのため、1つの画面で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 があればその銘柄を更新する」という処理よりも安全です。実際の行情システムでは、1種類のメッセージだけを扱うとは限らず、将来的に注文板や取引ステータスなどのデータを追加することもあるためです。

銘柄コードは購読時と同じ形式にする

もう1つ見落とされやすいのが、銘柄コードの形式です。

市場によって銘柄コードの形式は異なり、単純な数字だけとは限りません。例えばAllTickのコード体系では、香港株に 700.HK、米国株に AAPL.US のようなコードを使用します。A株についても市場を示すサフィックス付きのコードを使用します。接続する前に、対象コードが対応する商品リストに存在することを確認する必要があります。

そのため、アプリケーション内部でコードを独自に別形式へ変換することは避けたほうがよいでしょう。

例えば:

text
購読:700.HK
配信:700.HK
Map:700.HK

この3つを同じ形式にしておけば、その後の処理はシンプルになります。

もし開発者側で銘柄名、取引所、銘柄コードの対応表を管理しているのであれば、それも独立したデータ層として管理するのがおすすめです。WebSocketメッセージを受信するたびに、その場で銘柄名を組み立てる必要はありません。

複数銘柄のリアルタイム行情を同時に受信する場面では、AllTickは株式向けのWebSocket接続を提供しており、1回の購読リクエストで複数の銘柄コードを指定できます。この場合、アプリケーション側で配信メッセージの code を使ってルーティングする方法が自然です。

リアルタイム行情ボード、株式監視システム、またはクオンツ向けデータ接続サービスを開発しているのであれば、まず「メッセージタイプの識別 → 銘柄コードの識別 → 行情状態の更新」という3つの処理を分けて設計することをおすすめします。後から数銘柄から数百銘柄へ拡張する場合でも、メッセージ処理の設計を大きく変更する必要がなくなります。

AllTickの公式WebSocketドキュメントでは、株式のリアルタイム約定およびOrder Book購読に関するプロトコルが説明されています。具体的なフィールドやメッセージ構造を確認する際に利用できます。

今すぐマーケットデータ配信を開始

数秒で無料 API キーを発行し、1 つのエンドポイントからすべての市場に接続できます。