本文へ移動
QuantLabTickDirect

ドキュメントはじめに

クイックスタート

契約してから、Python のサンプルでティックを受け取るまでの手順です。

1. プランを契約する

ggguilds の商品ページで、同時に接続する IP アドレスの数に合うプランを選びます。支払いは Coinbase Wallet から USDC で行い、30 日ごとに自動で更新されます。プランの違いはプランと同時接続数を参照してください。

2. APIキーを発行する

初回の入金が確定すると、ggguilds の契約画面の「APIキー」タブで APIキーを発行できます。

  • キー ID(ggg_ で始まる値)と、秘密鍵(PKCS#8 の PEM ファイル)を受け取ります。
  • 秘密鍵は、発行したときに 1 度だけ表示されます。ソースコードやログに出さず、アクセス権を絞ったファイルなどに保管してください。漏れたときは、契約画面から再発行してください(古いキーは使えなくなります)。
  • 発行したキーが Tick サーバーで使えるようになるまで、最大で 1 分ほどかかります。それまでは認証が UnknownKey で拒否されます。

3. 接続先を選ぶ

  • 東京18 シンボル

    tokyo-alpha-1.tick.quantlab.fi:17000

    AWS 東京リージョンap-northeast-1

  • シンガポール18 シンボル

    singapore-alpha-1.tick.quantlab.fi:17000

    AWS シンガポールリージョンap-southeast-1

  • ロンドン20 シンボル

    london-alpha-1.tick.quantlab.fi:17000

    AWS ロンドンリージョンeu-west-2

  • ニューヨーク11 シンボル

    newyork-alpha-1.tick.quantlab.fi:17000

    AWS ニューヨーク Local Zoneus-east-1-nyc-2a

  • クライアントから Tick サーバーの 17000/UDP へ送信できるようにしてください。Tick サーバーからの応答とティックは、送信に使ったソケットに届きます。
  • 接続できるのは IPv4 だけです。
  • クライアントを Tick サーバーと同じ AWS リージョンに置くと、届くまでの時間が短くなります。

4. Python のサンプルで受け取る

Python 3.10 以降と、PyJWT が要ります。

pip install "pyjwt[crypto]"
curl -O https://quantlab.fi/downloads/freqrelay_client.py
python freqrelay_client.py --server tokyo-alpha-1.tick.quantlab.fi:17000 \
  --key-id ggg_xxxxxxxx --key-file ggguilds-api-key.pem \
  --symbols EURUSD,USDJPY

認証と購読が済むと、ティックを 1 件ずつ表示し、5 秒ごとに集計を表示します。

Authenticated
Subscribed to 2 symbols: EURUSD, USDJPY
EURUSD bid=1.08529 ask=1.08540 upstream=09:41:08.108Z
USDJPY bid=151.01200 ask=151.02500 upstream=09:41:08.112Z
...
datagrams=992 ticks=1041 lost=0 delivery-latency p50=65us p99=140us

Ctrl+C で止めると、サンプルは空の Subscribe を送って購読を終わらせます。IP アドレスの枠はすぐに空きます。オプションと、うまくいかないときの確かめ方は Python サンプルにあります。

5. 自分のクライアントを作る

接続の流れ、認証(JWT)、メッセージの形式を参照してください。実装で気をつけることは実装の注意にまとめています。