okx-cex-bot

OKX CEX ボット取引

OKX でのグリッドおよび DCA（現物・コントラクトのマーチンゲール）ボット管理。すべてのボットは OKX ネイティブのサーバーサイド型 です。OKX 上で実行され、ローカルプロセスは必要ありません。

事前確認

コマンドを実行する前に、../_shared/preflight.md に従ってください。 ステップ 2 の参照情報として、このファイルのフロントマターにある metadata.version を使用してください。

前提条件

npm install -g @okx_ai/okx-trade-cli
okx config init   # select site -> follow browser OAuth flow

セキュリティ：チャットで認証情報を受け取ることは絶対にしないでください。セットアップには okx config init を使うようユーザーに案内してください。

認証情報とプロファイルの確認

認証が必要なコマンドを実行する前に、毎回実行してください。 認証方式は事前確認のステップ 2 で検出され、セッション中は記憶されます。

ステップ A — 認証情報を確認する

両方のコマンドを実行してください。okx auth status --json の apiKey フィールドは認証バイナリの内部状態であり、~/.okx/config.toml に API キープロファイルがあるかどうかにかかわらず、常に false です。API キーの有無を確認する唯一の信頼できる情報源は okx config show --json です。

okx config show --json      # reveals API-key profiles (TOML config)
okx auth status --json      # reveals OAuth session state (auth-binary state)

次の順序で適用してください。最初に一致した項目を使用します。

• config show --json に api_key フィールドが空でないプロファイルがある → API キーモード。ステップ B に進みます。
• API キープロファイルがなく、かつ auth status --json が "status":"logged_in" を返す → OAuth モード。ステップ B に進みます。
• API キープロファイルがなく、かつ "status":"pending" → ログイン処理中です。完了するまで待ってください。
• API キープロファイルがなく、かつ "status":"not_logged_in" → 停止し、okx-cex-auth スキルを読み込んでログイン手順に従い、完了を待ってください。

ステップ B — 取引モードを確認する

確認方法：

1. ユーザーの意図が明確（「real」／「実盤」／「live」→ live、「test」／「模擬」／「demo」→ demo）→ そのモードを使用し、ユーザーに伝えます
2. 明示的な指定がない → 会話の文脈から以前の選択を確認し、見つかった場合は再利用します
3. 何も見つからない → 「Live（実盤）ですか、Demo（模擬盤）ですか？」と尋ね、回答を待ってから続行します

モードの適用方法は、認証方式（ステップ A で検出）によって異なります。

認証方式	Live（実盤）	Demo（模擬盤）
API キー	--profile <live-profile>	--profile <demo-profile>
OAuth	(フラグ不要。デフォルトは live)	--demo

• API キーのユーザー：okx config show --json を実行し、利用可能なプロファイル名と demo の設定を確認してください。
• OAuth のユーザー：live ではフラグを省略し、シミュレーション取引では --demo を追加してください。

コマンド実行後は毎回、[mode: live] または [mode: demo] を付けてください。

401 エラーへの対応

認証エラー（エラーに「401」、「Session expired」、または「Run okx auth login first」が含まれる場合）：

1. 直ちに停止します
2. okx-cex-auth スキルを読み込み、再認証手順に従います
3. 元のコマンドを再試行します

スキルの振り分け

必要な情報	スキル
市場データ、価格、板情報	okx-cex-market
口座残高、ポジション、手数料	okx-cex-portfolio
通常の現物／スワップ／先物注文	okx-cex-trade
グリッド／DCA ボット	okx-cex-bot（このスキル）

コマンド一覧

グリッドボット

コマンド	種別	説明
okx bot grid create	WRITE	グリッドボット（現物またはコントラクト）を作成
okx bot grid amend	WRITE	稼働中のグリッドボットの価格範囲、グリッド数、または TP/SL を変更
okx bot grid stop	WRITE	グリッドボットを停止
okx bot grid positions	READ	オープン中のコントラクト・グリッドポジションを照会（清算価格、証拠金率、未実現損益）
okx bot grid liquidate-price	READ	コントラクト・グリッドボットの清算価格を推定
okx bot grid close-position	WRITE	stopType=2 でボットを停止した後、残りのポジションを決済
okx bot grid orders	READ	稼働中または履歴のグリッドボットを一覧表示
okx bot grid details	READ	グリッドボットの詳細と損益
okx bot grid sub-orders	READ	個々のグリッド約定または未約定注文

DCA ボット（現物・コントラクト）

コマンド	種類	説明
okx bot dca create	WRITE	DCA（マーチンゲール）ボット（現物またはコントラクト）を作成します
okx bot dca stop	WRITE	DCA ボット（現物またはコントラクト）を停止します
okx bot dca orders	READ	アクティブまたは履歴の DCA ボットを一覧表示します（デフォルト：contract_dca）
okx bot dca details	READ	DCA ボットの詳細と損益を取得します
okx bot dca sub-orders	READ	DCA サイクルとサイクル内の注文を表示します
okx bot dca add-margin	WRITE	実行中のコントラクト DCA ボットに証拠金を追加します
okx bot dca reduce-margin	WRITE	実行中のコントラクト DCA ボットの証拠金を減らします
okx bot dca update-tp	WRITE	実行中のコントラクト DCA ボットの利確価格を更新します

スマートポートフォリオボット

注：--modules bot.smartportfolio または bot.all で読み込みます（デフォルトのモジュールには含まれません）。

コマンド	種類	説明
okx bot smart-portfolio create	WRITE	スマートポートフォリオボットを作成します（2～10 個の資産、合計が 1.0 になる比率、deltaRatio しきい値）
okx bot smart-portfolio stop	WRITE	実行中のスマートポートフォリオボットを停止します
okx bot smart-portfolio orders	READ	スマートポートフォリオボットを一覧表示します（デフォルト：実行中。停止済みのボットを表示するには --history を追加）
okx bot smart-portfolio details	READ	スマートポートフォリオボットの詳細と現在の配分を取得します
okx bot smart-portfolio amend-rebalance	WRITE	リバランスのしきい値と間隔を更新します（--deltaRatio と --interval の両方が必要です）
okx bot smart-portfolio instant-rebalance	WRITE	リバランスを即時実行します
okx bot smart-portfolio recommend-zones	READ	OKX が推奨するポートフォリオゾーン設定を参照します
okx bot smart-portfolio zones-backtest	READ	推奨ゾーンの過去のバックテスト結果を取得します

操作の流れ

ステップ 1 — ボットの種類と操作を特定する

ユーザーのリクエストを解析し、モジュール（Grid／DCA／Smart Portfolio）と操作（作成／停止／一覧表示／詳細）を特定します。

ステップ 2 — 実行する

READ コマンド（orders、details、sub-orders）：プロファイルを確認した後、すぐに実行します。

WRITE コマンド（create、amend、stop）：実行前に、主要なパラメーターをユーザーに一度確認します。

ステップ 3 — 書き込み後に確認する

• 作成後 → 対応する orders コマンドを実行し、アクティブであることを確認します
• 変更後 → details --algoId <id> を実行し、設定が更新されたことを確認します
• Grid／DCA の停止後 → orders --history を実行し、停止したことを確認します
• Smart Portfolio の停止後 → smart-portfolio orders --history を実行し、停止したことを確認します

重要なルール

• 資金を自動で振り替えてはいけません。 ボットの作成に必要な残高が不足している場合は、不足額（現在の利用可能額と必要額）を報告し、どのように進めるかユーザーに確認します：（1）手動で資金を振り替える、（2）サイズを縮小する、または（3）キャンセルする。
• algoId はボットのアルゴ注文 ID です（作成または一覧表示の出力から取得します）。通常の ordId ではありません。捏造せず、必ず先行するコマンドから取得してください。
• グリッドの algoOrdType は、ボットの実際の種類と一致させる必要があります。必ず bot grid orders の値を使用し、ユーザーの説明だけから推測しないでください。不一致の場合、エラー 50016 が発生します。
• 既存のボットを操作する場合、ユーザーが明示的に ID を指定していない限り、正しい ID を取得するために必ず最初に一覧表示してください。
• TP/SL の制約：tpTriggerPx／tpRatio と slTriggerPx／slRatio は、相互に排他的なペアです。

CLI コマンドリファレンス

Grid Bot のコマンド構文、パラメーターテーブル、クイックスタートの例、注意点については、 {baseDir}/references/grid-commands.md を参照してください。

DCA Bot のコマンド構文、パラメーターテーブル、クイックスタートの例、注意点については、 {baseDir}/references/dca-commands.md を参照してください。

Smart Portfolio Bot のコマンド構文、パラメーターテーブル、例については、 {baseDir}/references/smart-portfolio-commands.md を参照してください。

スキルをまたぐワークフローの例（ボット作成時に okx-cex-market／okx-cex-portfolio を連携させる方法）については、 {baseDir}/references/workflows.md を参照してください。

コミュニケーションガイドライン

• グリッド／DCA：「戦略」ではなく「ボット」を使用します（例：「グリッドボット」、「DCAボット」）。
• DCA：必ず「DCA」または「マーチンゲール」と表記します。DCA は現物 DCA とコントラクト DCA の両方に対応しています。
• 中国語：グリッド＝「网格」、現物 DCA＝「现货马丁」、コントラクト DCA＝「合约马丁」、スマートポートフォリオ＝「智能组合」
• パラメーターは自然な言葉で尋ねます。「価格の範囲は？」と尋ね、「minPx と maxPx を入力してください」とはしません。
• ユーザーがすでに値を提示している場合は、その値を直接割り当て、再度尋ねないでください。

{base} と {quote}：instId を - で分割して抽出します。例：BTC-USDT-SWAP → base=BTC、quote=USDT。

全般的な注意事項

• すべてのボットは OKX サーバー上で稼働します。CLI を停止しても影響はありません。
• 認証方法と取引モードは「認証情報とプロファイルの確認」で決定されます。パラメーターのルールについては、そのセクションを参照してください。
• --json はデフォルトで OKX API v5 の生のレスポンスを返します。出力を {"env": "<live|demo>", "profile": "<name>", "data": <response>} の形式でラップするには、--env を追加します。
• レート制限：UID ごとに 2 秒あたり 20 リクエスト
• グリッドの --gridNum の範囲：2～100