OKX CEX Trading CLI

OKXエクスチェンジでのスポット、パーペチュアルスワップ、デリバリー先物、オプション、およびイベントコントラクトの注文管理。注文の発注、キャンセル、修正、監視、オプションチェーンとGreeksの照会、バイナリアウトカムイベントコントラクト（Yes/No、Up/Down）のトレード、テイクプロフィット/ストップロス、トレーリングストップの設定、レバレッジとポジションの管理が可能です。APIクレデンシャルが必須です。

CLI vs MCPツール名 — サブコマンドはハイフンではなくスペースを使用します（okx swap algo place、okx bot grid create）。MCPツール識別子（swap_place_algo_order）をハイフン区切りのCLIコマンド（okx swap place-algo）に変換しないでください。「Unknown command」エラーが返されます。モジュール別のマッピングテーブルは references/<module>-commands.md に記載されています。

事前準備

../_shared/preflight.md に従ってください。 このファイルのfrontmatterから metadata.version を参照として使用してください（ステップ2）。

前提条件

1. okx CLIをインストール:

   npm install -g @okx_ai/okx-trade-cli
   

2. クレデンシャルを設定:

   okx config init   # サイトを選択 → ブラウザOAuthフローに従う
   

3. デモモードでテスト（シミュレーション取引、実資金なし）:

   okx --demo spot orders
   

セキュリティ: チャットでクレデンシャルを受け入れないでください。ユーザーに okx config init での設定を案内してください。

クレデンシャル & プロファイルチェック

認証済みコマンドを実行する前にこのチェックを実行してください。 認証方法は事前準備ステップ2で検出され、セッション中は保持されます。

ステップA — クレデンシャルの確認

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

okx config show --json      # APIキープロファイルを表示（TOMLConfig）
okx auth status --json      # OAuthセッション状態を表示（認証バイナリ状態）

この順序で適用します — 最初にマッチしたものが採用されます：

• 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" → ライブ; "test" / "模拟" / "demo" → デモ） → それを使用してユーザーに通知
2. 現在のメッセージに明示的な宣言がない → 会話のコンテキストで過去の選択を確認：
   • 見つかった → それを再利用して、ユーザーに通知
   • 見つからない → 質問: "Live (实盘) or Demo (模拟盘)?" — 回答を待ってから続行

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

認証方法	ライブ (实盘)	デモ (模拟盘)
APIキー	--profile <live-profile>	--profile <demo-profile>
OAuth	(フラグ不要、ライブがデフォルト)	--demo

• APIキーユーザー: okx config show --json を実行して利用可能なプロファイル名とその demo 設定を確認します。--profile <name> を使用して正しいプロファイルを選択します。
• OAuthユーザー: ライブトレーディングの場合はフラグを省略します。シミュレーション取引の場合は --demo を追加します。モード切り替えに --profile を使用しないでください。

認証エラーの処理

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

1. 直ちに停止 — 同じコマンドの再試行をしない
2. ユーザーに通知: 「認証に失敗しました。セッションが有効期限切れの可能性があります。」
3. okx-cex-auth スキルを読み込み、再認証ステップに従う
4. 再認証成功後、元のコマンドを再試行

デモ vs ライブモード

モード	資金	APIキーパラメータ	OAuthパラメータ
实盘 (ライブ)	実資金 — 戻しできない	--profile <live-profile>	(デフォルト、フラグなし)
模拟盤 (デモ)	シミュレーション — 実資金なし	--profile <demo-profile>	--demo

ルール:

1. トレードモードはすべての認証済みコマンドで必須 — 「クレデンシャル & プロファイルチェック」ステップBで決定されます
2. コマンド実行後の応答には必ず [mode: live] または [mode: demo] を追記します

スキルルーティング

• 市場データ（価格、チャート、デプス、ファンディングレート） → okx-cex-market を使用
• アカウント残高、P&L、ポジション、手数料、転送 → okx-cex-portfolio を使用
• 通常のスポット/スワップ/先物/オプション/アルゴ注文 → okx-cex-trade（このスキル）を使用
• イベントコントラクトの閲覧/発見（利用可能なもの、数、アクティブなリスト） → okx event browse / okx event series で okx-cex-trade を使用
• イベントコントラクトのトレード（予測市場注文の発注/キャンセル/修正） → okx event place / okx event cancel / okx event amend で okx-cex-trade を使用
• グリッド及びDCA トレーディングボット → okx-cex-bot を使用

重要: ユーザーがイベントコントラクトまたは予測市場のコンテキストで「コントラクト」について質問する場合、このスキルにルーティングしてください。okx-cex-portfolio にはルーティングしないでください。ポートフォリオはイベントコントラクトを処理しません。アカウント残高、ポジション、P&L、および転送のみを対象としています。

Szハンドリング（デリバティブ）

⚠ 重要: 注文を発注する前に必ずコントラクトの額面価格を確認してください

SWAP/FUTURES/OPTION注文を発注する前に、market_get_instruments を呼び出して ctVal（コントラクト額面価格）を取得してください。コントラクトサイズを想定しないでください — 商品によって異なります（例：ETH-USDT-SWAP = 0.1 ETH/コントラクト、BTC-USDT-SWAP = 0.01 BTC/コントラクト）。

ctVal を使用して:

• ユーザーの意図するポジションサイズから正しいコントラクト数を計算
• 注文を送信する前にマージン要件を確認
• ユーザーに実際のポジション値を表示: sz × ctVal × price

SWAP及びFUTURES注文

USDT建てサイジング用の3つのtgtCcyモード:

--tgtCcy	szの意味	変換公式	例："500U" at 10x lever
base_ccy (デフォルト)	コントラクト数	変換なし	500コントラクト
quote_ccy	USDT名目価値	floor(sz / (ctVal * lastPx))	500 USDT名目
margin	USDT証拠金コスト	floor(sz * lever / (ctVal * lastPx))	500 USDT証拠金 = 5000 USDT名目

ユーザーがUSDT金額を指定した場合（例："200U"、"500 USDT"、"$1000"）: → 曖昧 — これは名目価値または証拠金コストを意味する可能性があります。 続行する前にユーザーに明確にしてもらう必須:

• 名目価値: sz = USDTでのポジション価値（例：500 USDTは500 USD相当のコントラクトを直接購入）
• 証拠金コスト: 実際のポジション = sz × レバレッジ（例：10倍で500 USDT証拠金 = 5000 USDT名目ポジション） ユーザーの回答を待ってから続行。
• 名目価値の場合 → --tgtCcy quote_ccy を使用
• 証拠金コストの場合 → --tgtCcy margin を使用

ユーザーがコントラクト数を指定した場合（例："2 张"、"5 contracts"）: → 最初に market_get_instruments で ctVal を確認してから、コントラクト数で --sz を使用します。ユーザーに確認: 「X コントラクト = X × ctVal 原資産、総価値 ≈ $Y」。

ユーザーがユニット無しのプレーンな数字を与えた場合（スワップ/先物用）: → 曖昧 — 続行する前にユーザーに明確にしてもらう必須:

• コントラクト数: X コントラクト（各々はctVal分の原資産価値）
• USDT名目価値: USDTでのポジション価値
• USDT証拠金コスト: 証拠金額（実際のポジション = X × レバレッジ） ユーザーの回答を待ってから続行。

⚠ インバースコントラクト（*-USD-SWAP、*-USD-YYMMDD）: tgtCcy=quote_ccy と tgtCcy=margin も機能します（注：インバース商品では quote_ccy = USDT ではなくUSD）。常に警告: 「これはインバースコントラクトです。マージンとP&Lはテザー（USDT）ではなくビットコイン（BTC）で決済されます。」

オプション注文

ユーザーがオプションのUSDT金額を指定する場合、--tgtCcy quote_ccy（名目）または --tgtCcy margin（証拠金コスト）を使用して、金額を --sz として渡します。システムは自動的にコントラクトに変換します。注：オプションコントラクトは通常大きな額面価格を持ちます（例：ctVal=1 BTC ≈ $84,000）。そのため1コントラクトの最小USDT額は高いです。オプション売り手（cross/isolated tdMode）の場合、margin モードはレバレッジを自動的に考慮します。

クイックスタート

# スポットで0.01 BTC の市場買い
okx spot place --instId BTC-USDT --side buy --ordType market --sz 0.01

# スポットで$10相当のSOLを購入（USDT金額）
okx spot place --instId SOL-USDT --side buy --ordType market --sz 10 --tgtCcy quote_ccy

# スポットで0.01 BTCを$100,000のリミット売却
okx spot place --instId BTC-USDT --side sell --ordType limit --sz 0.01 --px 100000

# BTCパーペチュアル1コントラクトのロング（クロスマージン）
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 \
  --tdMode cross --posSide long

# BTCパーペチュアル1000 USDT名目価値のロング（コントラクトに自動変換）
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1000 \
  --tgtCcy quote_ccy --tdMode cross --posSide long

# 現在のレバレッジで500 USDT証拠金でロング（例：10倍 → 5000 USDT名目）
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 500 \
  --tgtCcy margin --tdMode cross --posSide long

# 添付TP/SL付きで1コントラクトのロング（ワンステップ）
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 \
  --tdMode cross --posSide long \
  --tpTriggerPx 105000 --tpOrdPx=-1 --slTriggerPx 88000 --slOrdPx=-1

# BTCパーペチュアルロングポジション全体を市場で平仓
okx swap close --instId BTC-USDT-SWAP --mgnMode cross --posSide long

# BTCパーペチュアルで10倍レバレッジを設定（クロス）
okx swap leverage --instId BTC-USDT-SWAP --lever 10 --mgnMode cross

# スポットBTCポジションのTP/SLを設定
okx spot algo place --instId BTC-USDT --side sell --ordType oco --sz 0.01 \
  --tpTriggerPx 105000 --tpOrdPx=-1 \
  --slTriggerPx 88000 --slOrdPx=-1

# BTCパーペチュアルロングにトレーリングストップを設定（コールバック2%）
okx swap algo trail --instId BTC-USDT-SWAP --side sell --sz 1 \
  --tdMode cross --posSide long --callbackRatio 0.02

# オープンなスポット注文を表示
okx spot orders

# オープンなスワップポジションを表示
okx swap positions

# スポット注文をキャンセル
okx spot cancel --instId BTC-USDT --ordId <ordId>

# --- イベントコントラクト ---
# イベントシリーズをリスト表示
okx event series

# シリーズ内のライブマーケットを閲覧
okx event markets BTC-ABOVE-DAILY --state live

# イベントコントラクト注文を発注
okx event place --instId BTC-ABOVE-DAILY-260224-1600-70000 --side buy --outcome YES --sz 10

コマンドインデックス

スポット注文（12個のコマンド）

#	コマンド	タイプ	説明
1	okx spot place	WRITE	スポット注文を発注（market/limit/post_only/fok/ioc）
2	okx spot cancel	WRITE	スポット注文をキャンセル
3	okx spot amend	WRITE	スポット注文の価格またはサイズを修正
4	okx spot algo place	WRITE	スポットTP/SLアルゴ注文を発注
5	okx spot algo amend	WRITE	スポットTP/SLレベルを修正
6	okx spot algo cancel	WRITE	スポットアルゴ注文をキャンセル
7	okx spot algo trail	WRITE	スポットトレーリングストップ注文を発注
8	okx spot orders	READ	オープンまたは履歴スポット注文をリスト表示
9	okx spot get	READ	単一のスポット注文詳細
10	okx spot fills	READ	スポット取引約定履歴
11	okx spot algo orders	READ	スポットTP/SLアルゴ注文をリスト表示
12	okx spot leverage	WRITE	スポットマージン（借入）のレバレッジを設定。ペアレベル（--instId）またはクロスカレンシーレベル（--ccy、借入有効化 / マルチ通貨 / ポートフォリオマージン用に必須）

完全なコマンド構文、パラメータテーブル、およびエッジケースについては、{baseDir}/references/spot-commands.md を参照してください。

スワップ / パーペチュアル注文（15個のコマンド）

#	コマンド	タイプ	説明
13	okx swap place	WRITE	パーペチュアルスワップ注文を発注
14	okx swap cancel	WRITE	スワップ注文をキャンセル
15	okx swap amend	WRITE	スワップ注文の価格またはサイズを修正
16	okx swap close	WRITE	ポジション全体を市場で平仓
17	okx swap leverage	WRITE	商品のレバレッジを設定
18	okx swap algo place	WRITE	スワップTP/SLアルゴ注文を発注
19	okx swap algo trail	WRITE	スワップトレーリングストップ注文を発注
20	okx swap algo amend	WRITE	スワップアルゴ注文を修正
21	okx swap algo cancel	WRITE	スワップアルゴ注文をキャンセル
22	okx swap positions	READ	オープンなパーペチュアルスワップポジション
23	okx swap orders	READ	オープンまたは履歴スワップ注文をリスト表示
24	okx swap get	READ	単一スワップ注文の詳細
25	okx swap fills	READ	スワップ取引約定履歴
26	okx swap get-leverage	READ	現在のレバレッジ設定
27	okx swap algo orders	READ	スワップアルゴ注文をリスト表示

完全なコマンド構文、パラメータテーブル、およびエッジケースについては、{baseDir}/references/swap-commands.md を参照してください。

先物 / デリバリー注文（15個のコマンド）

#	コマンド	タイプ	説明
28	okx futures place	WRITE	デリバリー先物注文を発注
29	okx futures cancel	WRITE	デリバリー先物注文をキャンセル
30	okx futures amend	WRITE	デリバリー先物注文の価格またはサイズを修正
31	okx futures close	WRITE	先物ポジション全体を市場で平仓
32	okx futures leverage	WRITE	先物商品のレバレッジを設定
33	okx futures algo place	WRITE	先物TP/SLアルゴ注文を発注
34	okx futures algo trail	WRITE	先物トレーリングストップ注文を発注
35	okx futures algo amend	WRITE	先物アルゴ注文を修正
36	okx futures algo cancel	WRITE	先物アルゴ注文をキャンセル
37	okx futures orders	READ	デリバリー先物注文をリスト表示
38	okx futures positions	READ	オープンなデリバリー先物ポジション
39	okx futures fills	READ	デリバリー先物約定履歴
40	okx futures get	READ	単一デリバリー先物注文の詳細
41	okx futures get-leverage	READ	現在の先物レバレッジ設定
42	okx futures algo orders	READ	先物アルゴ注文をリスト表示

完全なコマンド構文、パラメータテーブル、およびエッジケースについては、{baseDir}/references/futures-commands.md を参照してください。

オプション注文（10個のコマンド）

#	コマンド	タイプ	説明
43	okx option instruments	READ	オプションチェーン：原資産の利用可能コントラクトをリスト表示
44	okx option greeks	READ	インプライド・ボラティリティ + Greeks（デルタ/ガンマ/シータ/ベガ）を原資産別で表示
45	okx option place	WRITE	オプション注文を発注（コール/プット、買い/売り）
46	okx option cancel	WRITE	未約定のオプション注文をキャンセル
47	okx option amend	WRITE	オプション注文の価格またはサイズを修正
48	okx option batch-cancel	WRITE	最大20個のオプション注文をバッチキャンセル
49	okx option orders	READ	オプション注文をリスト表示（ライブ/履歴/アーカイブ）
50	okx option get	READ	単一オプション注文の詳細
51	okx option positions	READ	オープンなオプションポジション（ライブGreeks付き）
52	okx option fills	READ	オプション取引約定履歴

完全なコマンド構文、USDT からコントラクトへの変換公式、tdModeルール、およびエッジケースについては、{baseDir}/references/options-commands.md を参照してください。

イベントコントラクト注文（9個のコマンド）

#	コマンド	タイプ	説明
53	okx event browse	READ	アクティブなイベントコントラクトをタイプ別グループ化して閲覧（シリーズ + ライブマーケットをワンコールで）
54	okx event series	READ	イベントシリーズをリスト表示（例：BTC-ABOVE-DAILY、BTC-UPDOWN-15MIN）
55	okx event events <seriesId>	READ	シリーズ内のイベントをリスト表示
56	okx event markets <seriesId>	READ	マーケットをリスト表示。期限切れにはアウトカムと決済値を含む
57	okx event place ...	WRITE	イベント注文を発注（アウトカム必須）
58	okx event amend <instId> <ordId>	WRITE	イベント注文を修正（価格/サイズ）
59	okx event cancel <instId> <ordId>	WRITE	イベント注文をキャンセル
60	okx event orders	READ	保留中または履歴注文
61	okx event fills	READ	約定履歴

完全なコマンド構文、パラメータテーブル、およびエッジケースについては、{baseDir}/references/event-commands.md を参照してください。

操作フロー

ステップ0 — クレデンシャル & プロファイルチェック

認証済みコマンドの前に: クレデンシャル & プロファイルチェックを参照。実行前に認証方法とトレードモードを決定します。

すべてのコマンド結果の後: [mode: live] または [mode: demo] を追記します。

ステップ1 — 商品タイプとアクションを特定

スポット（instId形式：BTC-USDT）:

• 注文の発注/キャンセル/修正 → okx spot place/cancel/amend
• TP/SL条件付き → okx spot algo place/amend/cancel
• トレーリングストップ → okx spot algo trail
• 照会 → okx spot orders/get/fills/algo orders

スワップ/パーペチュアル（instId形式：BTC-USDT-SWAP）:

• 注文の発注/キャンセル/修正 → okx swap place/cancel/amend
• ポジション平仓 → okx swap close
• レバレッジ → okx swap leverage / okx swap get-leverage
• TP/SL条件付き → okx swap algo place/amend/cancel
• トレーリングストップ → okx swap algo trail
• 照会 → okx swap positions/orders/get/fills/get-leverage/algo orders

**