AllTick
-
リアルタイム市場データマーケットデータマーケットデプス注文板Level 1市場データ

Level 1 気配値とマーケットデプスの違いとは?買値・売値・数量・板の価格帯を解説

Level 1市場データとマーケットデプスの違いを解説。買い気配・売り気配、数量、板の価格帯、リアルタイム市場データAPIの選び方を紹介します。

AllTick読了 5 分

リアルタイム株価ページを開発する際、最初は最新価格を1つ表示するだけで十分なケースもあります。しかし、サービスの機能が増えるにつれて、最良買気配、最良売気配、それぞれの数量、さらには5本・10本の板情報まで必要になることがあります。その段階で、最初に接続したマーケットデータだけでは要件を満たせないことに気づく開発者も少なくありません。

ここでよく混同されるのが、Level 1 気配値とマーケットデプス(Market Depth)という2つの概念です。

どちらも買い・売りの気配に関する情報ですが、表示する内容は異なります。Level 1 は最良買気配と最良売気配に注目するのに対し、マーケットデプスはさらに複数の価格帯における買い注文と売り注文の状況を表示します。この違いを理解しておけば、リアルタイム行情 API でどのフィールドを取得すべきか、フロントエンドで何本の板を表示すべきかを判断しやすくなります。
Level 1 気配値では何を確認できるのか?
Level 1 気配値は通常、市場における最良気配を指します。具体的には、現在の最高買値(Best Bid)と最低売値(Best Ask)、およびそれぞれに対応する数量です。

例えば、ある銘柄の現在の気配が次のようになっているとします。

気配項目価格数量
最良買気配(Best Bid)100.001,200
最良売気配(Best Ask)100.05900

最良買気配は、買い手が提示している最も高い価格を表します。一方、最良売気配は、売り手が提示している最も低い価格です。この2つの価格の差が、ビッド・アスク・スプレッド(Bid-Ask Spread)です。

この例では、スプレッドは 0.05 になります。

リアルタイム行情ページであれば、通常これらの情報だけでも、現在の最良買気配・最良売気配、売買方向、スプレッドを表示できます。ユーザーがすべての注文を確認しなくても、市場の現在の気配状況を把握できます。

注意したいのは、最新約定価格は最良買気配や最良売気配と同じものではないという点です。最新約定価格は直近で成立した取引価格を示します。一方、最良買気配と最良売気配は、現在の注文板に存在する最も有利な買い・売りの価格を示します。そのため、両者が一致する場合もあれば、異なる場合もあります。

また、Level 1 の具体的なフィールド定義はデータプロバイダーによって異なります。データソースによっては、最新約定価格や出来高なども提供されます。そのため、API を接続する際は Level 1 という名称だけで判断せず、実際のレスポンス構造を確認する必要があります。

マーケットデプスは Level 1 より何が多いのか?

Level 1 が最良買気配と最良売気配だけを表示するのに対し、マーケットデプスでは、買いの2本目・3本目、さらにその先の価格帯にある買い注文と売り注文も確認できます。

例えば、次のような仮想的な板データを考えてみましょう。

買い板の段階買値買い数量売り板の段階売値売り数量
買い1 / 売り1100.001,200売り1100.05900
買い2 / 売り299.952,400売り2100.101,500
買い3 / 売り399.901,800売り3100.152,100

このデータから分かるように、Level 1 では買い板と売り板の最初の1段目を取得すれば十分ですが、マーケットデプスでは、それ以外の価格帯と対応する数量も表示できます。

これは、注文板(Order Book)画面を開発する際に特に重要です。

例えば、最良買気配の数量が 1,200 と表示されていても、それだけで他の価格帯に買い注文がないとは判断できません。買いの2段目や3段目も確認することで、より低い価格帯にどれだけの注文が存在するのかを把握できます。

ただし、マーケットデプスを利用すれば、市場に存在するすべての注文を確認できるというわけではありません。一般的な複数段の板情報は、価格帯ごとに集計された数量を表示するものであり、個々の注文を1件ずつ表示する注文単位のデータ(Level 3)とは異なります。

もう1つ混同しやすいのが、板数量と出来高です。この2つは同じフィールドではありません。板数量は特定の価格帯に存在する買い注文または売り注文の数量を表します。一方、出来高はすでに成立した取引の数量を表します。開発時に板数量を累計出来高として扱わないように注意が必要です。

リアルタイム行情 API に接続する場合、どちらを選ぶべきか?

選択の基準は、アプリケーションで何を表示したいかによって変わります。

一般的な株価表示カードを開発していて、最新約定価格、最良買気配、最良売気配、スプレッドだけを表示したいのであれば、通常は Level 1 で十分です。

一方、取引端末、板情報モニタリング画面、クオンツ分析ツールなどを開発しており、複数の価格帯における注文の分布を確認したい場合は、マーケットデプスのデータを接続する必要があります。

AllTick を例にすると、WebSocket の深度購読インターフェースでは、bids と asks によって買い板と売り板が返され、それぞれの価格と数量は price と volume で表されます。開発者は実際に返された配列を利用して、Level 1 の気配値画面や複数段の注文板を構築できます。

例えば、香港株の Tencent Holdings(700.HK)について、5段の板情報を購読する場合、次のようなメッセージを送信できます。

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
  };
}

ここで注意したいのは、すべての銘柄が必ず5段や10段のデータを返すと、フロントエンド側で決めつけないことです。AllTick のインターフェースでは、depth_level を指定して購読する深度を設定できます。このフィールドを指定しない場合、デフォルトでは1段のみ返されます。また、実際に利用できる深度を超える段数をリクエストした場合は、提供可能な段数のデータが返されます。

現在、公式ドキュメントに記載されている最大深度も市場によって異なります。

市場タイプ最大板情報の深度
香港株10段
上海・深圳A株5段
暗号資産5段
米国株1段
外国為替・貴金属・原油1段

したがって、プログラムから5段のデータをリクエストしても、すべての市場で5段が返されるわけではありません。また、公式ドキュメントでは、一部のCFD指数には volume フィールドが提供されないことも明記されています。複数市場に対応する場合は、数量フィールドが空になる可能性も考慮する必要があります。

継続的に更新される行情ページでは、HTTP リクエストを何度も送信するよりも、WebSocket で深度データのプッシュを受信する方法が一般的に適しています。画面に最新約定価格も表示する必要がある場合は、対応する Tick データも別途接続してください。最良買気配や最良売気配を最新約定価格の代わりに使用することはできません。

市場データを選ぶときは、板の段数だけで判断しない

Level 1 とマーケットデプスは、それぞれ異なるレベルの情報ニーズに対応しています。

Level 1 は最良買気配と最良売気配を素早く把握するためのもので、マーケットデプスはさらに複数の価格帯における注文状況を確認するためのものです。価格表示だけが必要なアプリケーションでは、複数段の注文板を接続すると、必要以上のデータ処理が増える可能性があります。一方、板情報の分析が必要なアプリケーションでは、Level 1 だけでは要件を満たせないことがあります。

開発を始める前に、画面で必要となるフィールド、板の段数、対象市場で実際に利用できる深度を確認したうえで、適切な API を選択することが重要です。

AllTick は REST API と WebSocket API の両方を提供しています。買い板・売り板の変化を継続的に受信するアプリケーションでは、WebSocket 深度購読ドキュメントを参照し、購読プロトコル、depth_level パラメータ、レスポンスフィールドを確認できます。また、AllTick API 公式ドキュメントも確認し、具体的なビジネス要件に適した行情データの接続方法を選択してください。

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

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