本文へ移動
QuantLabTickDirect

ドキュメント接続仕様

実装の注意

クライアントを実装するときに気をつけることです。

ソケット

  • 認証から受信まで、1 つの UDP ソケットを使い続けてください。送信元のポートが変わると、別の購読者として扱われます。
  • 受信バッファは大きめ(数 MB)に取ってください。全シンボルを購読すると、毎秒数千のデータグラムが届くことがあります。Linux では SO_RCVBUF の上限が net.core.rmem_max で決まります。
  • ファイアウォールや NAT の内側からでも、Tick サーバーへ送ったのと同じソケットで受け取れば、ティックは届きます。1 秒ごとの Heartbeat が NAT の対応を保ちます。

受信の処理

  • 受信のループでは、templateId で種類を見分けてください。認証や購読の応答を待っている間にも Ticks が届きます。
  • Ticks の要素は前から順に処理してください。1 つのデータグラムに、同じシンボルのティックが複数入ることがあります。
  • Python のように 1 件ずつの処理が遅い言語で全シンボルを受け取るときは、受信のスレッドを分けて、受け取ったデータグラムをすぐキューに移してください。

欠損の検知

  • sequence は購読者ごとのデータグラムの連番で、1 から始まります。前に受け取った値より 2 以上大きければ、その間のデータグラムが失われています。
  • 認証し直して新しい購読者になると、sequence は 1 から始まり直します。
  • 失われたティックは送り直されません。そのシンボルの値は、次のティックで最新になります。

時刻と価格

  • 時刻はすべて UTC の、1970-01-01 からのナノ秒です。LP ごとのタイムゾーンは、Tick サーバーが外してから送ります。
  • 価格は × 10⁸ の固定小数点(int64)です。浮動小数点に変換する前に、整数のまま比べたり差を取ったりできます。

届くまでの時間を測る

受信時刻(receiveTime)と、クライアントがデータグラムを受け取った時刻の差が、Tick サーバーからクライアントまでにかかった時間の目安です。2 台の時計のずれを含むので、クライアントの時計は NTP(AWS なら Amazon Time Sync Service)で合わせてください。

終わり方

  • プロセスを止める前に、空の Subscribe を送ってください。IP アドレスの枠がすぐに空きます。
  • 送らずに止めた場合は、Heartbeat が途絶えてから 5 秒で枠が空きます。その前に別の IP アドレスから接続しようとすると、IpLimitReached になることがあります。