メッセージは FIX SBE(Simple Binary Encoding)で表します。正式な定義は SBE スキーマ(freqrelay-sbe.xml、スキーマ ID 1、version 1)です。数値はすべてリトルエンディアンです。
メッセージヘッダー
すべてのメッセージは、8 バイトのメッセージヘッダーで始まります。
| オフセット | 型 | 項目 | 値 |
|---|---|---|---|
| 0 | uint16 | blockLength | ルートブロック(ヘッダーの後ろの固定長の部分)のバイト数 |
| 2 | uint16 | templateId | メッセージの種類(下の表) |
| 4 | uint16 | schemaId | 1 |
| 6 | uint16 | version | 1 |
| templateId | メッセージ | 向き |
|---|---|---|
| 1 | Subscribe | クライアント → Tick サーバー |
| 2 | SubscribeAck | Tick サーバー → クライアント |
| 3 | Heartbeat | クライアント → Tick サーバー |
| 4 | HeartbeatAck | Tick サーバー → クライアント |
| 5 | Ticks | Tick サーバー → クライアント |
| 6 | Hello | クライアント → Tick サーバー |
| 7 | Challenge | Tick サーバー → クライアント |
| 8 | Authenticate | クライアント → Tick サーバー |
| 9 | AuthenticateAck | Tick サーバー → クライアント |
読むときの決まり
- ルートブロックの後ろ(繰り返しグループ)の位置は、ヘッダーの
blockLengthから求めてください。将来、ルートブロックの末尾に項目が足されることがあります。 - 繰り返しグループは、4 バイトのグループヘッダー(uint16
blockLength= 1 要素のバイト数、uint16numInGroup= 要素の数)に続いて、要素が並びます。要素の位置も、グループヘッダーのblockLengthから求めてください。 schemaIdが 1 でないメッセージは無視してください。
以下の表のオフセットは、メッセージヘッダーの直後(先頭から 8 バイト目)を 0 とした位置です。
Ticks(5)
購読したシンボルのティックです。下の図は、ティック 1 件を含む Ticks の全体(54 バイト)です。
000008000500010001003207000000000000
001022000100030000c377060000000058de
0020770600000000a575ffedbdcbe818a575
0030ffedbdcbe818
00000800050001000100
00083207000000000000
001022000100030000c3
001877060000000058de
0020770600000000a575
0028ffedbdcbe818a575
0030ffedbdcbe818
| messageHeader | 0–7 | blockLength 8、templateId 5(Ticks)、schemaId 1、version 1 | |
| sequence | 8–15 | 1842(購読者ごとの連番) | |
| groupSize | 16–19 | 要素 34 バイト、1 件 | |
| symbolId | 20–21 | 3(EURUSD) | |
| bid | 22–29 | 108512000 → 1.08512 | |
| ask | 30–37 | 108519000 → 1.08519 | |
| upstreamTime | 38–45 | 受信時刻と同じ(Alpha は時刻を送らない) | |
| receiveTime | 46–53 | 2026-11-17 09:41:08.109342117 UTC |
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint64 | sequence(購読者ごとのデータグラムの連番。1 から始まる) |
| 8 | グループヘッダー | 要素は 34 バイト |
| 12 + 34 × i | uint16 | シンボル ID |
| 14 + 34 × i | int64 | Bid(価格 × 10⁸) |
| 22 + 34 × i | int64 | Ask(価格 × 10⁸) |
| 30 + 34 × i | int64 | 上流時刻(LP がティックに付けた時刻。UTC、1970-01-01 からのナノ秒) |
| 38 + 34 × i | int64 | 受信時刻(Tick サーバーがティックを受け取った時刻。UTC、ナノ秒) |
- 1 つのデータグラムに、そのとき溜まっていた複数のティックが入ることがあります。同じシンボルのティックが複数入ることもあります。要素は Tick サーバーが受け取った順に並んでいるので、前から順に処理してください。
- 価格は固定小数点です。Bid が
108512000なら 1.08512 です。 sequenceに抜けがあれば、その数のデータグラムが失われています。ティックは次の更新で上書きされるので、Tick サーバーは送り直しません。- 同じシンボルで、すでに送ったティックより上流時刻が古いティックは送りません。
Hello(6)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint8[32] | 詰め物(すべて 0) |
全体で 40 バイトです。詰め物を省いた Hello には、Tick サーバーは応えません。
Challenge(7)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint8[16] | cookie |
Authenticate(8)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint32 | requestId(AuthenticateAck にそのまま返る) |
| 4 | uint16 | JWT の長さ(1,024 以下) |
| 6 | uint8[長さ] | JWT(コンパクト形式。ASCII) |
AuthenticateAck(9)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint32 | requestId |
| 4 | uint8 | result(認証の結果) |
| 5 | uint8[16] | 購読者トークン(Accepted のときだけ有効。それ以外は 0) |
Subscribe(1)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint8[16] | 購読者トークン |
| 16 | uint32 | requestId(SubscribeAck にそのまま返る) |
| 20 | グループヘッダー | 要素は 16 バイト、64 個まで |
| 24 + 16 × i | char[16] | シンボル名(UTF-8、余りは 0 で埋める) |
- 購読を、送ったシンボルの集合で置き換えます。
- 空の集合を送ると、購読者が終わります。
SubscribeAck(2)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint32 | requestId |
| 4 | uint8 | result(0 = Accepted、1 = UnknownSubscriber) |
| 5 | グループヘッダー | 要素は 18 バイト |
| 9 + 18 × i | uint16 | シンボル ID(存在しないシンボルは 65535) |
| 11 + 18 × i | char[16] | シンボル名 |
Acceptedのときは、要求したシンボルごとに、要求と同じ順で 1 件ずつ返ります。UnknownSubscriberは、購読者トークンがこの送信元では使えないことを表します(購読者が終わった、別の送信元から送った、Tick サーバーが再起動した)。要素はありません。Helloからやり直してください。
Heartbeat(3)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint8[16] | 購読者トークン |
HeartbeatAck(4)
| オフセット | 型 | 項目 |
|---|---|---|
| 0 | uint8 | subscribed(1 = 購読が続いている、0 = 終わった) |
| 1 | uint8 | upstreamStatus(LP との接続の状態) |
| 2 | uint8 | endReason(購読が終わった理由。subscribed が 1 のときは 0) |