本文へ移動
QuantLabTickDirect

ドキュメント接続仕様

メッセージの形式

SBE のメッセージごとの、バイトの並びです。

メッセージは FIX SBE(Simple Binary Encoding)で表します。正式な定義は SBE スキーマ(freqrelay-sbe.xml、スキーマ ID 1、version 1)です。数値はすべてリトルエンディアンです。

メッセージヘッダー

すべてのメッセージは、8 バイトのメッセージヘッダーで始まります。

オフセット型項目値
0uint16blockLengthルートブロック(ヘッダーの後ろの固定長の部分)のバイト数
2uint16templateIdメッセージの種類(下の表)
4uint16schemaId1
6uint16version1
templateIdメッセージ向き
1Subscribeクライアント → Tick サーバー
2SubscribeAckTick サーバー → クライアント
3Heartbeatクライアント → Tick サーバー
4HeartbeatAckTick サーバー → クライアント
5TicksTick サーバー → クライアント
6Helloクライアント → Tick サーバー
7ChallengeTick サーバー → クライアント
8Authenticateクライアント → Tick サーバー
9AuthenticateAckTick サーバー → クライアント

読むときの決まり

  • ルートブロックの後ろ(繰り返しグループ)の位置は、ヘッダーの blockLength から求めてください。将来、ルートブロックの末尾に項目が足されることがあります。
  • 繰り返しグループは、4 バイトのグループヘッダー(uint16 blockLength = 1 要素のバイト数、uint16 numInGroup = 要素の数)に続いて、要素が並びます。要素の位置も、グループヘッダーの blockLength から求めてください。
  • schemaId が 1 でないメッセージは無視してください。

以下の表のオフセットは、メッセージヘッダーの直後(先頭から 8 バイト目)を 0 とした位置です。

Ticks(5)

購読したシンボルのティックです。下の図は、ティック 1 件を含む Ticks の全体(54 バイト)です。

Ticks メッセージ(ティック 1 件)54 バイト
00000800050001000100
00083207000000000000
001022000100030000c3
001877060000000058de
0020770600000000a575
0028ffedbdcbe818a575
0030ffedbdcbe818
messageHeaderblockLength 8、templateId 5(Ticks)、schemaId 1、version 1
sequence1842(購読者ごとの連番)
groupSize要素 34 バイト、1 件
symbolId3(EURUSD)
bid108512000 → 1.08512
ask108519000 → 1.08519
upstreamTime受信時刻と同じ(Alpha は時刻を送らない)
receiveTime2026-11-17 09:41:08.109342117 UTC
オフセット型項目
0uint64sequence(購読者ごとのデータグラムの連番。1 から始まる)
8グループヘッダー要素は 34 バイト
12 + 34 × iuint16シンボル ID
14 + 34 × iint64Bid(価格 × 10⁸)
22 + 34 × iint64Ask(価格 × 10⁸)
30 + 34 × iint64上流時刻(LP がティックに付けた時刻。UTC、1970-01-01 からのナノ秒)
38 + 34 × iint64受信時刻(Tick サーバーがティックを受け取った時刻。UTC、ナノ秒)
  • 1 つのデータグラムに、そのとき溜まっていた複数のティックが入ることがあります。同じシンボルのティックが複数入ることもあります。要素は Tick サーバーが受け取った順に並んでいるので、前から順に処理してください。
  • 価格は固定小数点です。Bid が 108512000 なら 1.08512 です。
  • sequence に抜けがあれば、その数のデータグラムが失われています。ティックは次の更新で上書きされるので、Tick サーバーは送り直しません。
  • 同じシンボルで、すでに送ったティックより上流時刻が古いティックは送りません。

Hello(6)

オフセット型項目
0uint8[32]詰め物(すべて 0)

全体で 40 バイトです。詰め物を省いた Hello には、Tick サーバーは応えません。

Challenge(7)

オフセット型項目
0uint8[16]cookie

Authenticate(8)

オフセット型項目
0uint32requestId(AuthenticateAck にそのまま返る)
4uint16JWT の長さ(1,024 以下)
6uint8[長さ]JWT(コンパクト形式。ASCII)

AuthenticateAck(9)

オフセット型項目
0uint32requestId
4uint8result(認証の結果)
5uint8[16]購読者トークン(Accepted のときだけ有効。それ以外は 0)

Subscribe(1)

オフセット型項目
0uint8[16]購読者トークン
16uint32requestId(SubscribeAck にそのまま返る)
20グループヘッダー要素は 16 バイト、64 個まで
24 + 16 × ichar[16]シンボル名(UTF-8、余りは 0 で埋める)
  • 購読を、送ったシンボルの集合で置き換えます。
  • 空の集合を送ると、購読者が終わります。

SubscribeAck(2)

オフセット型項目
0uint32requestId
4uint8result(0 = Accepted、1 = UnknownSubscriber)
5グループヘッダー要素は 18 バイト
9 + 18 × iuint16シンボル ID(存在しないシンボルは 65535)
11 + 18 × ichar[16]シンボル名
  • Accepted のときは、要求したシンボルごとに、要求と同じ順で 1 件ずつ返ります。
  • UnknownSubscriber は、購読者トークンがこの送信元では使えないことを表します(購読者が終わった、別の送信元から送った、Tick サーバーが再起動した)。要素はありません。Hello からやり直してください。

Heartbeat(3)

オフセット型項目
0uint8[16]購読者トークン

HeartbeatAck(4)

オフセット型項目
0uint8subscribed(1 = 購読が続いている、0 = 終わった)
1uint8upstreamStatus(LP との接続の状態)
2uint8endReason(購読が終わった理由。subscribed が 1 のときは 0)