okx-trading

OKX プロバイダーブローカースキル

src/providers/okx/* を編集する際は、このワークフローを使用してください。

1. 必要なリファレンスのみを読み込む

• SDK の使用パターンとメソッド名については、references/okx-sdk-usage.md を読んでください。
• エラーからアクションへのマッピングについては、references/okx-error-map.md を読んでください。
• ソース全体のコンテキストが必要な場合に限り、不足している詳細を .trae/okx-api-llm.txt で確認してください。

2. アーキテクチャとの互換性を維持する

• src/providers/types.ts（BrokerProvider、MarketDataProvider、OptionsProvider）との互換性を維持してください。
• OKX 固有の拡張 API は、汎用プロバイダーメソッドが引き続き動作するようにしながら、OKX プロバイダーインターフェース（例：OkxTradingProvider）の背後に配置してください。
• src/providers/broker-factory.ts が、アダプターとの互換性を損なわずに OKX プロバイダーを返せるようにしてください。

3. 認証と署名のルールを徹底する

• API キー、シークレット、パスフレーズの 3 つすべてを必須にしてください。
• OKX の署名用プリハッシュには、timestamp + UPPERCASE_METHOD + requestPathWithQuery + rawBody を使用してください。
• REST とプライベート WebSocket 認証の両方で、customSignMessageFn による HMAC SHA256 base64 署名を使用してください。
• シミュレーション取引では demoTrading: true を渡してください。

4. 取引とマーケットの最低対応範囲

• 取引：現物、マージン、スワップ／先物、オプションの注文発行・キャンセル／照会・一覧取得。
• アカウント：残高、ポジション、請求／取引履歴、約定。
• マーケットデータ：ティッカー（単一／複数）、オーダーブック、取引、ローソク足、金融商品。
• WebSocket：ティッカー、オーダーブック、取引、ローソク足、アカウント／注文／ポジションのサブスクリプション。

5. エラーとレート制限の処理

• OKX の code と msg のエラーを解析し、内部エラーカテゴリーにマッピングしてください。
• 既知の認証／注文／リスク／レート制限コードを明示的に処理してください。
• リトライ可能な失敗に対し、リクエストのスロットリングと、指数バックオフおよびジッターを用いた再試行を適用してください。
• 無効な入力や認証エラーは再試行しないでください。

6. コード変更時のドキュメント要件

• 現在のメソッド名に合った例を記載するため、src/providers/okx/README.md を更新してください。
• 現物注文、先物注文、オプション注文、アカウント履歴、WebSocket サブスクリプションについて、それぞれ 1 つずつ例を含めてください。
• SDK の実際の使用方法に即した例を記載し、references/okx-sdk-usage.md に準拠させてください。