OKX でのスポット取引の API 権限を管理するにはどうすればよいですか?

現物取引のAPI権限設定

1. 本人確認を完了したら、OKX アカウント ダッシュボード内の [API 管理] セクションにアクセスします。

2. 「API キーの作成」をクリックし、現物取引操作に必要な特定の権限を選択します。

3. 「読み取り」権限を有効にして、残高情報、注文履歴、市場データを取得します。

4. サポートされているすべての取引ペアにわたってスポット注文を発注、キャンセル、および変更するには、 「取引」権限を有効にします。

5. スポット実行とは関係のないセキュリティ リスクの上昇を引き起こすため、明示的に必要な場合を除き、 「引き出し」を有効にすることは避けてください。

IP ホワイトリストと認証強化

1. スポット取引に使用される各 API キーに静的 IPv4 または IPv6 アドレス、または CIDR サブネットを割り当てます。

2. 取引関連のリクエストを開始する前に、IP バインディングがアクティブであることを確認します。取引許可を持つバインドされていないキーは、非アクティブな状態が 14 日間続くと期限切れになります。

3. すべてのプライベート エンドポイント呼び出しにHMAC-SHA256 署名を使用し、タイムスタンプ、HTTP メソッド、要求パス、および本文ハッシュを組み込みます。

4.パスフレーズを秘密キーとは別に保存し、スタック トレースに記録されたり公開されたりしないようにします。

5. API キーを四半期ごとにローテーションし、古いキーは API 管理インターフェイスを介して直ちに取り消します。

スポット注文執行の制約

1. 偶発的なマージンまたはファンディングモードのアクティブ化を防ぐために、すべてのスポット注文ペイロードでtdMode = 'cash'を指定します。

2. 注文を送信する前に、OKX の商品メタデータに対して価格とサイズの精度を検証します。BTC-USDT では、価格精度 0.01 とサイズ精度 0.00000001 が必要です。

3. ordType = 'limit'または'market'を明示的に設定します。このフィールドを省略すると、環境間で一貫性のないデフォルトの動作が引き起こされます。

4. クライアント側の注文追跡にclOrdIdを含め、セッション間での識別子の再利用を避けます。

5. 50113 (署名の不一致) や58007 (オークション範囲を超えた価格の逸脱) などの応答コードを監視します。どちらも設定が間違っているスポット送信でよく見られます。

OKX デモ環境を使用したワークフローのテスト

1. テストネット ドメインに flag=1 で別の API キーを登録し、シミュレーション トラフィックをライブ残高から分離します。

2. KYC 要件なしで OKX フォーセットを使用してデモ アカウントに資金を供給します。各割り当ては 72 時間後に期限切れになります。

3. テストネットと運用環境の両方で同一のスポット注文ロジックを実行し、レイテンシー、拒否率、約定確認タイミングを比較します。

4. GET /api/v5/trade/orders-history-archive が環境間で一貫したページネーション構造を返すことを確認します。

5. Books50-l2-tbtチャネルへの WebSocket サブスクリプションが、認証エラーなしでリアルタイムの深度更新を配信することを確認します。

EU ユーザー向けの MiCA 準拠 API ガバナンス

1. OKX European Ltd は、2025 年 1 月 27 日の時点で、EEA の 30 の管轄区域すべてをカバーする完全な MiCA 認可を取得しています。

2. EU ベースの API キーは、より厳しいレート制限を自動的に適用します。グローバルのデフォルトである 20 リクエストではなく、1 秒あたり 15 リクエストです。

3. 取引エンドポイントは、 X-MiCA-JurisdictionおよびX-Compliance-Levelを含む追加の規制ヘッダーを返します。

4. すべてのスポット注文確認には、原資産の MiCA 登録ステータスに関連付けられた不変のComplianceReferenceIdが含まれます。

5. MiCA コンプライアンス ポータルを通じて明示的に有効にしない限り、引き出し関連のエンドポイントは EU キーに対して無効のままです。

よくある質問

Q: 現物取引と先物取引の両方に同じ API キーを使用できますか?はい。ただし、作成時に両方の instType カテゴリに対して「取引」権限が有効になっている場合に限ります。監査を明確にするために、別のキーを使用することをお勧めします。

Q: スポット注文でエラー コード 58000 が返されるのはなぜですか?これは、要求された商品が取引のために一時停止されていることを示します。 OKX の公式機器ステータス ページを確認するか、instType=SPOT を指定してGET /api/v5/public/instrumentsを呼び出します。

Q: パスフレーズでは大文字と小文字が区別されますか?はい。 OKX は SHA-256 ハッシュを保存するため、大文字と小文字が異なると無効な署名が生成されます。

Q: API キーが侵害されているかどうかを確認するにはどうすればよいですか? API Management の「最近のアクティビティ」タブを確認します。認識されない IP、予期しない出金試行、または注文キャンセル量の急増による信号の露出。