OKX 取引ボットのセットアップ方法: 完全な自動化ガイド

API キーの構成とセキュリティ プロトコル

1. OKX アカウントにログインし、[アカウント設定] の [API 管理] セクションに移動します。

2. 「取引」および「読み取り」機能のみに対する明示的な権限を持つ新しい API キーを生成します。絶対に必要な場合を除き、出金権を有効にしないでください。

3. バージョン管理による偶発的な公開を防ぐために、API キー、秘密キー、およびパスフレーズをプロジェクト ディレクトリの外の暗号化された.env ファイルに保存します。

4. IP アドレスのホワイトリストを割り当てて、既知のサーバーの場所またはローカルの開発マシンへの API アクセスを制限します。

5. API 認証情報を 90 日ごとにローテーションし、OKX ダッシュボードの [取り消し] ボタンを使用して侵害されたキーを直ちに取り消します。

コアモジュール統合戦略

1. pip install python-okx 経由で python-okx をインストールします。これにより、WebSocket やリクエストを含む必要な依存関係がすべて手動介入なしでプルされます。

2. TradeAPI インスタンスと FundingAPI インスタンスを個別に初期化して、注文実行を残高クエリから分離し、モジュール間の状態競合を回避します。

3. MarketData.py を使用して、注文を行う前にリアルタイムのティッカー データを取得します。これにより、市場の変動が激しいときの古い価格仮定を防ぐことができます。

4. REST エンドポイントをポーリングする代わりに、ライブ注文ステータスを更新するために WebSocketFactory を実装し、レイテンシと API レート制限の消費を削減します。

5. 複数の資産を同時に管理して独立した注文帳コンテキストを維持する場合、各取引ペアを TradeAPI の専用インスタンスにマッピングします。

注文の執行とリスクの執行

1. 厳密な検証を使用して注文パラメータを構築します。instId は OKX の公式商品リストと一致する必要があり、tdMode は口座タイプ (キャッシュ、マージン、または分離) と一致する必要があり、ordType は指値、マーケット、またはストップのいずれかである必要があります。

2. get_ticker() からの最後の取引価格と px を比較することにより、価格偏差チェックを強制します。絶対差が現在の市場価格の 3% を超える注文を拒否します。

3. ログ、交換記録、および調整レポートにわたる追跡可能性を実現するために、すべてのリクエストにクライアント注文 ID (clOrdId) を添付します。

4. 有効期限 (tif) を「GTT」 (Good Till Time) に設定し、指値注文の有効期限を 60 秒に設定して、孤立した未約定命令がシステム内に残るのを防ぎます。

5. get_positions() および get_orders_history() 呼び出しを使用して、事前定義されたしきい値を超えるポジションの不均衡を検出すると、オープン注文の自動キャンセルをトリガーします。

リアルタイムデータ処理アーキテクチャ

1. HTTP オーバーヘッドなしで低遅延のフィード取り込みを行うために、books5、ティッカー、キャンドルなどのパブリック チャネルへの永続的な WebSocket 接続を確立します。

2. 受信する深度更新にメッセージレベルのチェックサム検証を導入して、破損または切り捨てられたペイロードを戦略ロジックに到達する前に破棄します。

3. 生の WebSocket メッセージをメモリに最大 500 ミリ秒バッファリングし、それらを 2 番目に整列された間隔にバッチ処理して、一貫した K ライン集約を実現します。

4. プライベート チャネル イベント (注文一致通知など) を、市場データ処理パイプラインから独立して動作する専用のハンドラー スレッドにルーティングします。

5. ディスクに書き込むか外部アラート サービスに転送する前に、受信したすべての取引約定とポジション変更を構造化された JSON 形式にシリアル化します。

導入環境の検証

1. 運用環境に展開する前に、OKX のサンドボックス環境で flag='1' を使用して完全な統合テストを実行します。発注から約定確認までの注文ライフサイクルを検証します。

2. アクティブな取引セッション中に少なくとも 1 時間に 1 回、get_balances() 出力を OKX Web UI 値と比較して、資金残高の同期を確認します。

3. WebSocketFactory の組み込みロギング フックを使用して、ping 間隔、再接続数、メッセージ損失率などの接続健全性メトリクスを監視します。

4. 不正な形式の注文リクエストを意図的に送信し、正しいエラー コード (無効な機器 ID の場合は「51000」など) で例外が発生することを確認することによって、エラー応答解析を検証します。

5. ログ ローテーション設定を監査して、ファイル サイズの切り捨てやパスの構成ミスによって重要なトランザクション タイムスタンプや注文 ID が失われないようにします。

よくある質問

Q: 単一の API キーで複数のボットを実行できますか? A: いいえ。各ボットは、きめ細かい権限制御と独立した取り消し機能を確保するために、個別の API キーを使用する必要があります。キーを共有すると、監査証跡が曖昧になり、セキュリティ上の危険が増大します。

Q: ボットが取引中に WebSocket 接続を失った場合はどうなりますか? A: python-okx は、指数バックオフを使用して再接続の試行を自動的に開始します。保留中の注文確認は、get_orders_pending() への REST フォールバック呼び出しを介して回復され、状態の一貫性が維持されます。

Q: python-okx を通じてストップマーケットなどの条件付き注文を行うことは可能ですか? A: はい。 ordType='stop' または ordType='stop_market' をtriggerPriceおよびスリッページパラメータとともに使用します。 tdMode が基礎となる口座構造と一致していることを確認してください。マージン口座には追加の posSide 仕様が必要です。

Q: ボットがレバレッジ設定を正しく適用しているかどうかを確認するにはどうすればよいですか? A: instId および mgnMode 引数を指定して get_leverage() を呼び出します。返されたレバレッジ値を設定されたポジションサイズおよびマージンバランスと照合して、意図しないスケーリング効果を検出します。