既存のポジションに影響を与えずに OKX のレバレッジを調整するにはどうすればよいですか?

レバレッジ調整メカニズムを理解する

1. OKX でのレバレッジの変更は、ポジションごとではなくマージン モード レベルで適用されます。ユーザーがクロスマージンモードと個別マージンモードを切り替えるか、レバレッジ値を変更すると、システムは現在の市場状況とオープンオーダーの状態に基づいてマージン要件を再計算します。

2. レバレッジを調整しても、自動清算やポジションの決済はトリガーされません。プラットフォームは、調整後に維持証拠金が十分に残っている限り、未決注文を含むすべてのアクティブなポジションを保持します。

3. 分離された証拠金ポジションは、専用の証拠金プールを保持します。 1 つの孤立したポジションのレバレッジを変更しても、他の孤立したポジションやクロスマージンバランスには影響しません。

4. クロスマージンモードでは、取引口座の利用可能な残高全体を担保として使用します。ここでレバレッジを変更すると、各ポジションに割り当てられる共有プールの量に影響しますが、新しい注文が出されない限り再割り当てが強制されることはありません。

5. OKX は、レバレッジの変更を適用する前に厳密な検証を実施します。要求されたレバレッジによって即時証拠金不足が発生する場合、API はエラー コード 51008 を返し、更新を拒否します。

段階的なレバレッジ変更フロー

1. GET /api/v5/account/positionsを使用して現在のポジションのステータスを取得し、銘柄 ID、ポジション側、マージン モードを確認します。

2. 証拠金として使用される特定の通貨 (USDT マージン契約の場合は USDT) に焦点を当てて、 GET /api/v5/account/balanceでマージンの利用可能性を確認します。

3. 正確なパラメータ ( instId 、レバー、 mgnMode 、およびposSide )を使用してレバレッジ変更リクエストを作成します。必須フィールドを省略すると拒否されます。

4. POST /api/v5/account/set-leverage経由でリクエストを送信します。応答には監査追跡用の一意のordIdが含まれており、新しいレバレッジ値を確認します。

5. 位置の詳細を再取得して変更を検証します。応答のレバーフィールドは送信された値と一致する必要があり、 marginとmaintMargin はポジション状態を変更せずに更新された計算を反映する必要があります。

レバレッジの更新中によくある落とし穴

1. ポジションが清算またはADL (自動デレバレッジ) 状態にあるときにレバレッジを調整しようとすると、即座に拒否されます。ユーザーは、ポジションがこれらの重大な状態を抜けるまで待つ必要があります。

2. レバレッジを商品の最大許容値 (ポジション サイズと段階的証拠金ルールによって決定される) より高く設定すると、エラー 50007 が発生します。この制限は資産と契約の種類によって異なります。

3. リクエストの署名で古いタイムスタンプを使用すると、エラーが発生します。 5. OKX サーバーは、内部クロックに対して時間のずれを検証します。 ±30 秒を超える偏差がある場合、認証は無効になります。

4. 100 ミリ秒以内に重複したレバレッジ リクエストを送信すると、レート制限に違反します。 API は、100 ミリ秒ウィンドウごとに、金融商品ごとに 1 回の成功したレバレッジ変更を強制します。

5.クロスマージン識別子と孤立マージン識別子を混同すると、パラメータの不一致が発生します。 mgnModeフィールドは、大文字と小文字が区別される「cross」または「isolate」のみを受け入れます。

API 統合のベスト プラクティス

1. API 認証情報には、ハードコーディングするのではなく、常に環境変数を使用します。 OKX_API_KEY 、 OKX_SECRET_KEY 、およびOKX_PASSPHRASE をバージョン管理から除外された.envファイルに保存します。

2. HTTP 429 応答の指数バックオフを使用した再試行ロジックを実装します。 OKX では、取引エンドポイントに対して 1 秒あたり 20 リクエストが許可されていますが、レバレッジ調整はこの割り当てにカウントされます。

3. 位置データをローカルにキャッシュし、更新を送信する前にタイムスタンプを比較します。不要な呼び出しが頻繁に発生すると、失敗のリスクが高まり、レート制限が消費されます。

4. flagパラメータを正しく使用します。デモ取引の場合は「1」に設定し、ライブ口座の場合は「0」に設定します。これらのフラグをエンドポイント間で混在させると、一貫性のない状態が作成されます。

5. 応答コードを厳密に検証します。ステータス 200 は成功を保証するものではありません。 JSON 本文内のコードフィールドを確認してください。 「0」のみが適切に実行されたことを示します。

よくある質問

Q: 複数のポジションのレバレッジを同時に変更できますか? A: いいえ。各レバレッジ調整は、単一の機器と位置のサイドの組み合わせを対象としています。バッチ更新では、適切なレート制限を処理した連続的な API 呼び出しが必要です。

Q: レバレッジの変更は未実現損益の計算に影響しますか? A: いいえ。含み損益はエントリー価格、マーク価格、ポジションサイズを使用して計算されたままになります。レバレッジは証拠金の使用量に影響しますが、損益計算には影響しません。

Q: 有効なリクエストを送信した後、私のポジションに「レバレッジが変化していない」と表示されるのはなぜですか? A: これは、要求されたレバレッジが現在の値と等しい場合に発生します。 OKX は、同一の値を no-op 操作として扱い、処理をスキップします。

Q: レバレッジ調整に手数料はかかりますか? A: いいえ。OKX はレバレッジ設定の変更に取引手数料を請求しません。実際の注文の場合のみ手数料が発生します。