OKX CEX ポートフォリオ & アカウント CLI

OKX取引所のアカウント残高、ポジション、P&L、請求、手数料、資金転送。APIクレデンシャルが必要です。

プリフライトチェック

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

前提条件

1. okx CLIをインストールします：

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

2. クレデンシャルを設定します：

   okx config init   # サイト選択 → ブラウザのOAuthフロー開始
   

3. デモモードでテストします（シミュレーション取引、実資金は不使用）：

   okx --demo account balance
   

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

クレデンシャル & プロファイル確認

認証が必要なコマンドを実行する前に、この確認を実施してください。 認証方法はプリフライトステップ2で検出され、セッションで保持されます。

ステップA — クレデンシャルを確認する

両方のソースを確認します（プリフライト ステップ2の判定表を参照）。okx auth status --json単体は不十分です — apiKeyフィールドは常にfalseであり、TOML設定を反映していません。

okx config show --json      # APIキーの有無の決定的な出力
okx auth status --json      # OAuthセッション状態の決定的な出力

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

• config showに空でないapi_keyを持つプロファイルがある — APIキーモード。ステップBへ進みます。
• APIキープロファイルなしかつ auth statusが"status": "logged_in"を返す — OAuthモード。ステップBへ進みます。
• APIキープロファイルなしかつ auth statusが"status": "pending"を返す — ログイン進行中、待機します。
• APIキープロファイルなしかつ auth statusが"status": "not_logged_in"を返す — すべての操作を中止、okx-cex-authスキルを読み込みログインステップに従い、完了を待ちます。

ステップB — トレーディングモードを確認する

判定ルール：

1. 現在のメッセージの意図が明確（例："real" / "实盘" / "live" → 本番；"test" / "模拟" / "demo" → デモ）→ それを使用してユーザーに通知
2. 現在のメッセージに明示的な宣言がない → 会話コンテキストで前の選択を確認：
   • 見つかった → 再利用、ユーザーに通知
   • 見つからない → 質問：「本番 (实盘) またはデモ (模拟盘)?」 — 回答を待ってから進みます

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

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

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

認証エラーの処理

認証エラー（エラーに「401」「セッション期限切れ」「okx auth loginを実行してください」が含まれる）：

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

デモモード vs 本番モード

モード	資金	APIキー パラム	OAuth パラム
实盘 (本番)	実資金	--profile <live-profile>	(デフォルト、フラグなし)
模拟盤 (デモ)	シミュレーション資金	--profile <demo-profile>	--demo

# APIキーユーザー
okx --profile okx-prod  account balance     # 实盘
okx --profile okx-demo  account balance     # 模拟盤

# OAuthユーザー
okx account balance                          # 实盘 (デフォルト)
okx --demo account balance                   # 模拟盤

ルール：

• 読み取りコマンド（残高、ポジション、請求など）：常に使用されたモードを明記します
• 書き込みコマンド（transfer、set-position-mode）：実行前にモードを確認する必要があります（「クレデンシャル & プロファイル確認」ステップBを参照）；特に転送 — 誤ったモードは誤ったアカウントを意味します
• すべてのコマンド結果後のレスポンスには以下を追加します：[mode: live]または[mode: demo]

スキルルーティング

• 市場データ（価格、チャート、オーダーブック、ファンディングレート）→ okx-cex-marketを使用
• アカウント残高、P&L、ポジション、手数料、転送 → okx-cex-portfolio（このスキル）を使用
• 通常のスポット/スワップ/先物/アルゴ注文 → okx-cex-tradeを使用
• グリッドおよびDCA取引ボット → okx-cex-botを使用

クイックスタート

# トレーディングアカウント残高（残高 > 0 のすべての通貨）
okx account balance

# USDTのみの残高確認
okx account balance USDT

# ファンディングアカウント残高
okx account asset-balance

# すべてのオープンポジション
okx account positions

# 実現PnL付きクローズ済みポジション履歴
okx account positions-history

# 最近のアカウント請求（直近100件）
okx account bills

# 取引手数料ティア
okx account fees --instType SPOT

# ファンディング(6)からトレーディング(18)へUSDT 100を転送
okx account transfer --ccy USDT --amt 100 --from 6 --to 18

コマンド インデックス

読み取りコマンド

#	コマンド	タイプ	説明
1	okx account balance [ccy]	READ	トレーディングアカウント資産、利用可能、凍結
2a	okx account asset-balance [ccy]	READ	ファンディングアカウント残高（通貨ごとのリスト）
2b	okx account asset-balance [ccy] --valuation [--valuationCcy <ccy>]	READ	同上 + トレーディング/ファンディング/アーン全体の総資産評価値；通貨はデフォルトでUSDT、--valuationCcy BTCで上書き可
3	okx account positions	READ	オープンなコントラクト/スワップポジション
4	okx account positions-history	READ	クローズ済みポジション + 実現PnL
5	okx account bills	READ	アカウント台帳（入金、出金、取引）
6	okx account fees --instType <type>	READ	取引手数料ティア（メーカー/テーカー）
7	okx account config	READ	アカウントレベル、ポジションモード、UID
8	okx account max-size --instId <id> --tdMode <mode>	READ	現在の価格での最大買い/売りサイズ
9	okx account max-avail-size --instId <id> --tdMode <mode>	READ	次の注文での利用可能サイズ
10	okx account max-withdrawal [ccy]	READ	通貨ごとの最大引き出し可能額

書き込みコマンド

#	コマンド	タイプ	説明
11	okx account set-position-mode <mode>	WRITE	ネット/ヘッジポジションモード切り替え
12	okx account transfer	WRITE	アカウント間での資金転送

クロススキル ワークフロー

取引前の残高確認

ユーザー：「BTCを0.1買いたい — USDTは十分にあるか？」

1. okx-cex-portfolio okx account asset-balance --valuation   → USDT単位の総資産（トレーディング/ファンディング/アーン内訳）
   → details.trading を確認（トレーディングアカウント利用可能）
   → トレーディング残高 < 必要額の場合：details.funding を確認 — 転送が必要かもしれません
2. okx-cex-market    okx market ticker BTC-USDT              → 現在の価格を確認
        ↓ ユーザーが承認
3. okx-cex-trade     okx spot place --instId BTC-USDT --side buy --ordType market --sz 0.1

ボット前の残高確認

ユーザー：「USDTで1000でBTCグリッドボットを開始したい」

1. okx-cex-portfolio okx account asset-balance --valuation   → USDT単位の総資産（トレーディング/ファンディング/アーン内訳）
   → details.trading ≥ 1000 を確認（グリッドボットはトレーディングアカウントの資金が必要）
   → details.funding にUSDTがある場合：まず account transfer を使用
2. okx-cex-market    okx market candles BTC-USDT --bar 4H --limit 50  → 価格範囲を決定
        ↓ ユーザーが承認
3. okx-cex-bot       okx bot grid create --instId BTC-USDT --algoOrdType grid \
                       --minPx 90000 --maxPx 100000 --gridNum 10 --quoteSz 1000

オープンポジションとP&Lの確認

ユーザー：「現在のポジションと成績を表示」

1. okx-cex-portfolio okx account positions                  → UPL付きオープンポジション
2. okx-cex-portfolio okx account positions-history          → 最近クローズされたポジション
3. okx-cex-market    okx market ticker BTC-USDT-SWAP        → 現在価格と建値を確認

転送と取引

ユーザー：「ファンディングアカウントからトレーディングアカウントへUSDT 500を移動してBTCを取引」

1. okx-cex-portfolio okx account asset-balance USDT         → ファンディング残高 ≥ 500 を確認
        ↓ ユーザーが承認
2. okx-cex-portfolio okx account transfer --ccy USDT --amt 500 --from 6 --to 18
3. okx-cex-portfolio okx account balance USDT               → トレーディング残高が更新されたことを確認
        ↓ 取引準備完了
4. okx-cex-trade     okx spot place ...

注文前の最大ポジションサイズを確認

ユーザー：「クロスマージンでBTCをいくら買えるか？」

1. okx-cex-portfolio okx account balance                    → 総資産
2. okx-cex-portfolio okx account max-size --instId BTC-USDT-SWAP --tdMode cross  → 最大買い/売りサイズ
3. okx-cex-market    okx market ticker BTC-USDT-SWAP        → 現在価格参照

操作フロー

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

認証が必要なコマンド前に：クレデンシャル & プロファイル確認を参照。実行前に認証方法とトレーディングモードを決定します。

すべてのコマンド結果後： レスポンスに[mode: live]または[mode: demo]を追加します

ステップ1：アカウント操作を特定する

• 残高を確認 → okx account balance（トレーディング資産のみ）またはokx account asset-balance（ファンディング残高）またはokx account asset-balance --valuation（USDT単位のすべてのアカウント全体）
• オープンポジションを表示 → okx account positions
• クローズ済みポジション + PnLを表示 → okx account positions-history
• 取引履歴を表示 → okx account bills
• 手数料ティアを確認 → okx account fees
• アカウント設定を確認 → okx account config
• 注文サイズを計算 → okx account max-sizeまたはokx account max-avail-size
• 引き出し限度額を確認 → okx account max-withdrawal
• 資金を転送 → okx account transfer
• ポジションモードを変更 → okx account set-position-mode

ステップ2：読み取りコマンドはすぐに実行 — プロファイルを確認（ステップ0）してから書き込み

読み取りコマンド（1〜10）：確認不要、すぐに実行します。

• ccyフィルター：USDT、BTC、ETHなどの通貨シンボルを使用
• --instType手数料/ポジション：SPOT、SWAP、FUTURES、OPTION
• --archive請求：デフォルトウィンドウを超える古いレコードへのアクセス
• --tdMode最大サイズ：cash（スポット）、cross、isolated

書き込みコマンド（11〜12）：実行前に一度確認します。

• set-position-mode：モードを確認（net = 一方向、long_short_mode = ヘッジモード）；モード切り替えはオープンポジションに影響を与える可能性があります
• transfer：--ccy、--amt、--from、--toを確認（アカウント種別：6=ファンディング、18=トレーディング）；まずソース残高を確認

ステップ3：書き込み後の検証

• set-position-mode後：okx account configを実行してposModeが更新されたことを確認
• transfer後：okx account balanceとokx account asset-balanceを実行して残高が更新されたことを確認

CLIコマンド リファレンス

アカウント残高 — トレーディングアカウント

okx account balance [ccy] [--json]

パラメータ	必須	デフォルト	説明
ccy	いいえ	-	単一の通貨にフィルター（例：USDT）

テーブルを返します：currency、equity、available、frozen。残高 > 0 の通貨のみ表示します。

---

資産残高 — ファンディングアカウント

okx account asset-balance [ccy] [--valuation] [--valuationCcy <ccy>] [--json]

パラメータ	必須	デフォルト	説明
ccy	いいえ	-	特定の通貨にフィルター（例：USDT）；評価値の通貨単位には影響しません
--valuation	いいえ	false	すべてのアカウント種別（トレーディング/ファンディング/アーン）全体の総資産評価値も表示
--valuationCcy	いいえ	USDT	総資産評価値の通貨単位（例：USDT、BTC）。--valuationが設定されている場合のみ使用します。

返却：ccy、bal、availBal、frozenBal。残高 > 0 の通貨のみ表示します。

--valuation付きの場合：さらにtotalBalとアカウント種別ごとの内訳（classic/earn/funding/trading）を含む評価値サマリーテーブルを表示します。数値は--valuationCcy（デフォルトUSDT）で表示されます。

重要：ccy（残高フィルター）と--valuationCcy（評価値通貨単位）は独立したパラメータです — ccy=BTCは残高リストをBTC行にフィルターしますが、評価値通貨単位は変更しません；BTC単位の評価値には--valuationCcy BTCを明示的に設定します。

---

ポジション — オープンポジション

okx account positions [--instType <type>] [--instId <id>] [--json]

パラメータ	必須	デフォルト	説明
--instType	いいえ	-	フィルター：SWAP、FUTURES、OPTION
--instId	いいえ	-	特定の商品にフィルター

返却：instId、instType、side（posSide）、pos、avgPx、upl（未実現PnL）、lever。サイズ ≠ 0 のポジションのみ表示します。

---

ポジション履歴 — クローズ済みポジション

okx account positions-history [--instType <type>] [--instId <id>] [--limit <n>] [--json]

返却：instId、direction、openAvgPx、closeAvgPx、realizedPnl、uTime。

---

請求 — アカウント台帳

okx account bills [--archive] [--instType <type>] [--ccy <ccy>] [--limit <n>] [--json]

パラメータ	必須	デフォルト	説明
--archive	いいえ	false	古いレコード（アーカイブエンドポイント）にアクセス
--instType	いいえ	-	商品種別でフィルター
--ccy	いいえ	-	通貨でフィルター
--limit	いいえ	100	レコード数

返却：billId、instId、type、ccy、balChg、bal、ts。

---

手数料 — 取引手数料ティア

okx account fees --instType <type> [--instId <id>] [--json]

パラメータ	必須	デフォルト	説明
--instType	はい	-	SPOT、SWAP、FUTURES、OPTION
--instId	いいえ	-	特定の商品（オプション）

返却：level、maker、taker、makerU、takerU、ts。

---

設定 — アカウント設定

okx account config [--json]

返却：uid、acctLv（アカウントレベル）、posMode（ネット/long_short_mode）、autoLoan、greeksType、level、levelTmp。

---

最大サイズ — 最大注文サイズ

okx account max-size --instId <id> --tdMode <mode> [--px <price>] [--json]

パラメータ	必須	デフォルト	説明
--instId	はい	-	商品ID
--tdMode	はい	-	cash（スポット）、cross、isolated
--px	いいえ	-	参照価格（省略時はマーク価格を使用）

返却：instId、maxBuy、maxSell。

---

最大利用可能サイズ

okx account max-avail-size --instId <id> --tdMode <mode> [--json]

返却：instId、availBuy、availSell — 次の注文での即座に利用可能なサイズ。

---

最大引き出し可能額

okx account max-withdrawal [ccy] [--json]

返却テーブル：ccy、maxWd、maxWdEx（借用での最大額）。フィルターがない場合はすべての通貨を表示します。

---

ポジションモード設定

okx account set-position-mode <net|long_short_mode> [--json]

値	動作
net	一方向（デフォルト）— ロングとショートは相殺
long_short_mode	ヘッジモード — ロングとショートは共存可

警告：ポジションがオープンな状態でモードを切り替えると、予期しない動作が発生する可能性があります。まずokx account positionsを確認してください。

---

資金転送

okx account transfer --ccy <ccy> --amt <n> --from <acctType> --to <acctType> \
  [--transferType <type>] [--subAcct <name>] [--json]

パラメータ	必須	デフォルト	説明
--ccy	はい	-	転送する通貨（例：USDT）
--amt	はい	-	転送額
--from	はい	-	ソースアカウント種別：6=ファンディング、18=トレーディング
--to	はい	-	宛先アカウント種別：6=ファンディング、18=トレーディング
--transferType	いいえ	0	0=アカウント内、1=サブアカウント宛、2=サブアカウント発
--subAcct	いいえ	-	サブアカウント名（サブアカウント転送に必須）

返却：transId、ccy、amt。

---

MCPツール リファレンス

ツール	説明
account_get_balance	トレーディングアカウント残高
account_get_asset_balance	ファンディングアカウント残高。showValuation=trueで、トレーディング/ファンディング/アーンアカウント全体の総資産評価値を含めます。valuationCcy（デフォルト"USDT"）で評価値合計の通貨単位を設定します — 例：valuationCcy="BTC"はBTC単位で合計を返します。
account_get_positions	オープンポジション
account_get_positions_history	クローズ済みポジション履歴
account_get_bills	アカウント請求（最新）
account_get_bills_archive	アカウント請求（アーカイブ）
account_get_trade_fee	取引手数料ティア