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
| 地域 | 接続先 | 置き場所 | シンボル |
|---|---|---|---|
| 東京 | tokyo-alpha-1.tick.quantlab.fi:17000 | AWS 東京リージョンap-northeast-1 | 18 |
| シンガポール | singapore-alpha-1.tick.quantlab.fi:17000 | AWS シンガポールリージョンap-southeast-1 | 18 |
| ロンドン | london-alpha-1.tick.quantlab.fi:17000 | AWS ロンドンリージョンeu-west-2 | 20 |
| ニューヨーク | newyork-alpha-1.tick.quantlab.fi:17000 | AWS ニューヨーク Local Zoneus-east-1-nyc-2a | 11 |
- クライアントから 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 サンプルにあります。