okx-cex-smartmoney

OKX CEX Smart Money CLI

Smart Money のランキングボード、トレーダー分析、ポジション追跡、集約されたコンセンサスシグナル。

事前確認

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

前提条件

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

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

2. 認証情報を設定します。

   okx config init   # select site -> follow browser OAuth flow
   

3. 次のコマンドで確認します。okx smartmoney traders-by-filter --limit 5

セキュリティ：チャットで認証情報を受け取ることは絶対に避けてください。設定には okx config init を案内してください。

---

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

認証が必要なコマンドを実行する前に、両方のコマンドを実行してください。okx auth status --json の apiKey フィールドは認証バイナリの内部状態を示すものであり、~/.okx/config.toml に API キープロファイルがあるかどうかにかかわらず、常に false になります。API キーの有無を確認する唯一の信頼できる情報源は okx config show --json です。認証方法は事前確認の Step 2 で検出され、セッション中は記憶されます。

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 キーモード。続行します。
• API キープロファイルがなく、かつ auth status --json が "status":"logged_in" を返す → OAuth モード。続行します。
• API キープロファイルがなく、かつ "status":"pending" → ログイン処理中です。完了まで待ちます。
• API キープロファイルがなく、かつ "status":"not_logged_in" → 停止し、okx-cex-auth スキルを読み込んでログイン手順に従い、完了まで待ちます。

Smart Money はデモモードに対応していません（ランキングボードのデータはライブデータのみです）。常にライブモードを暗黙的に使用し、エラーがない限り言及しないでください。

• API キーユーザー：--profile <live-profile>（demo=true ではないプロファイル）を使用します。
• OAuth ユーザー：フラグは不要です（ライブがデフォルトです）。

認証エラー（401／「Session expired」／「Run okx auth login first」）が発生した場合：直ちに停止し、okx-cex-auth スキルを読み込んで再認証手順に従ってから、再試行してください。

---

スキルの振り分け

ユーザーの意図	振り分け先のスキル
市場価格、ティッカー、ローソク足	okx-cex-market
現物／スワップ／先物／オプションの注文	okx-cex-trade
口座残高、ポジション、送金	okx-cex-portfolio
グリッド／DCA 取引ボット	okx-cex-bot
Simple Earn、Flash Earn、On-chain Earn、Dual Investment（双币赢）、AutoEarn（自动赚币）	okx-cex-earn
Smart Money のランキングボード、シグナル、トレーダー分析	このスキル

---

コマンド一覧（10 個のコマンド、すべて読み取り専用）

トレーダー関連（6）

コマンド	種類	認証	説明
smartmoney traders-by-filter	READ	必須	プール条件（期間／minPnl／minWinRate／maxDrawdown／minAum）によるランキングボードの順位。authorId でページネーションします。名前には min*／max* のプレフィックスを使用します。シグナル側の *Tier 名前空間とは重複しません。
smartmoney performance-by-trader --authorIds <id1,id2>	READ	必須	1 人以上の authorId の損益／勝率プロファイル。--sortBy <pnl|pnlRatio>（デフォルトは pnl）と --period <3|7|30|90>（デフォルトは 90）で、順位付けと遡及期間を指定します。
smartmoney search-trader --keyword <name>	READ	必須	ニックネームのキーワードでトップトレーダーを検索します（最大 10 件、フォロワー数順）。
smartmoney trader-positions --authorId <id>	READ	必須	1 人のトレーダーの現在のオープンポジション。--instId <BTC-USDT-SWAP>（またはベース通貨のみ）で絞り込めます。
smartmoney trader-positions-history --authorId <id>	READ	必須	実現損益を含む決済済みポジションの履歴。posId でページネーションします。
smartmoney trader-orders-history --authorId <id>	READ	必須	注文／約定記録。ordId でページネーションします。

シグナル／コインファミリー（4）

コマンド	種類	認証	説明
smartmoney signal-overview-by-filter	READ	必須	複数資産のシグナルを、階層フィルターを適用したプールで集計します。--topInstruments（注目度の高い上位N件）または --instCcyList BTC,ETH,SOL（個別指定）のどちらか一方でコインを選択します。スマートマネーの中で最も注目されているコインを見つけるために使用します。
smartmoney signal-overview-by-trader --authorIds <id1,id2>	READ	必須	手動で選択したトレーダーのセットを対象に、複数資産のシグナルを集計します（authorIdsによる直接検索）。--topInstruments または --instCcyList でコインを選択します。--sortBy（デフォルトは pnl）と --period（デフォルトは 7）でパフォーマンス指標を指定します。パフォーマンス階層のフィルター（pnlTier / winRateTier など）は公開されていません。
smartmoney signal-trend-by-filter --instCcy <ccy> [--asOfTime <yyyyMMddHH>]	READ	必須	asOfTime（デフォルトは現在のUTC時刻）を基準とする、単一コインのスマートマネーシグナル時系列です。階層フィルターを適用したプールが対象です。--granularity 1h|1d と --limit で、バケットの粒度と件数を指定します。
smartmoney signal-trend-by-trader --authorIds <id1,id2> --instCcy <ccy> [--asOfTime <yyyyMMddHH>]	READ	必須	手動で選択したトレーダーのセットを対象に集計する、単一コインのスマートマネーシグナル時系列です（authorIdsによる直接検索）。--granularity 1h|1d（デフォルトは 1h）、--sortBy（デフォルトは pnl）、--period（デフォルトは 7）を指定します。パフォーマンス階層のフィルターは公開されていません。

時間の基準：signal-trend-by-{filter,trader} では、任意の --asOfTime <yyyyMMddHH>（UTCの10桁の時刻。例：2026050100）を指定できます。指定した時刻を基準に、その時刻までの最新の --limit 件のバケットを返します。--asOfTime を省略すると、現在のUTC時刻が使用されます。signal-overview-by-{filter,trader} では時刻を指定できず、ハンドラーは常に現在の時刻を使用します。

複数コインの選択：signal-overview-by-filter と signal-overview-by-trader では、--topInstruments（注目度の高い上位N件）または --instCcyList BTC,ETH,SOL（ベース通貨を明示的に指定）を使用できます。この2つのフラグは同時に指定できません。どちらも指定しない場合は、デフォルトで --topInstruments=20 が使用されます。

⚠ 無期限契約のみが対象です：4つの signal-* コマンドはすべて、USDT建ておよびUSDS建ての契約のみを集計します。コイン建ての契約（BTC-USD-SWAP、BTC-USD-DELIVERY、ETH-USD-SWAP など）は上流で除外されるため、トレーダーのコイン建てポジションは longNotional / shortNotional / tradersWithPosition から通知なく除外されます。トレーダーがそのコインのコイン建てエクスポージャーを大きく保有していても、無期限契約のポジションがなければ、シグナルには一切表示されません。コイン建てを含むトレーダーの全ポジションを確認するには、smartmoney trader-positions --authorId <id> を実行してください。

トレーダーの全体像を確認するには？ 旧 smartmoney trader 複合コマンドは削除されました。performance-by-trader、trader-positions、trader-orders-history を並列で実行してください。

コマンドの構文とパラメーターの詳細については、{baseDir}/references/trader-commands.md と {baseDir}/references/signal-commands.md を参照してください。

---

操作フロー

ステップ 0 — 認証情報とプロファイルの確認

認証が必要なコマンドを実行する前に、認証情報とプロファイルの確認を参照してください。常にライブモードを使用し、通知は表示しないでください。

ステップ 1 — 意図を特定する

トレーダーの検索／ランキング：

• 「おすすめのトレーダー」／「top traders」／「ランキング上位のトレーダー」 → 並べ替え／フィルタリングを指定して smartmoney traders-by-filter を実行します。{baseDir}/references/trader-commands.md を参照してください。
• 「あるトレーダーについて調べる」／「trader detail」 → performance-by-trader、trader-positions、trader-orders-history を並行して実行します（以前の複合コマンド smartmoney trader は削除されています）。
• 「alice／小明を検索」／「ニックネームでトレーダーを検索」 → smartmoney search-trader --keyword <name> を実行します（最大 10 件の一致結果を返し、他のツールに渡せる authorId が含まれます）。
• 「これらの authorId を確認」／authorId が既知の場合 → smartmoney performance-by-trader --authorIds <id1,id2> を実行します（直接検索。--sortBy／--period が適用され、デフォルトは pnl／90 です）。
• 「現在のポジションのみ」 → smartmoney trader-positions --authorId <id> を実行します。
• 「取引履歴」 → smartmoney trader-orders-history --authorId <id> を実行します（ページネーション対応）。
• 「過去の決済済みポジション」／「決済済みポジション」／「実現損益の実績」 → smartmoney trader-positions-history --authorId <id> を実行します（ページネーション対応）。

シグナル分析：

• 「BTC のスマートマネーシグナル」 → smartmoney signal-overview-by-filter --instCcyList BTC を実行します。{baseDir}/references/signal-commands.md を参照してください。
• 「BTC、ETH、SOL のシグナル」 → smartmoney signal-overview-by-filter --instCcyList BTC,ETH,SOL を実行します。
• 「このトレーダーたちはどの通貨を見ている？」／「指定したトレーダー間のコンセンサス」 → smartmoney signal-overview-by-trader --authorIds <id1,id2> を実行します（グループ内の上位 20 件の注目対象がデフォルトで選ばれます。または --instCcyList を指定してください）。
• 「スマートマネーはどの通貨を取引している？」 → smartmoney signal-overview-by-filter を実行します（デフォルトは --topInstruments=20 です）。{baseDir}/references/signal-commands.md を参照してください。
• 「シグナルの推移」／「時系列でのシグナルトレンド」 → smartmoney signal-trend-by-filter --instCcy <ccy> [--asOfTime <yyyyMMddHH>] [--limit 24] を実行します（authorIds で絞り込んだ推移には signal-trend-by-trader --authorIds <ids> --instCcy <ccy> を実行します）。

ステップ 2 — 実行して結果を提示する

すべてのコマンドは読み取り専用のため、確認は不要です。必ず --json を指定し、結果を Markdown テーブルで表示します。

複数ステップのワークフロー（トレーダーを推薦してから詳細を確認する、コンテキストを含めてシグナルを分析する）については、{baseDir}/references/workflows.md を参照してください。

---

全般的な注意事項

• セキュリティ： API キーやシークレットをチャットに貼り付けるよう、ユーザーに求めないでください。
• 出力： 一覧表示／検索コマンドでは必ず --json を指定し、結果を Markdown テーブルで表示してください。ターミナル出力をそのまま貼り付けてはいけません。
• ネットワークエラー： コマンドが接続エラーで失敗した場合は、VPN を確認するようユーザーに案内してください：curl -I https://www.okx.com
• 言語： 必ずユーザーの言語で応答してください。
• 時間の入力： signal-trend-by-{filter,trader} では、任意で --asOfTime <yyyyMMddHH>（UTC の 10 桁の時刻）を基準として指定できます。省略すると現在の UTC 時刻が使われます。--limit は、指定した基準時刻までに返されるバケット数を制御します。signal-overview-by-{filter,trader} は時間を入力しません。ハンドラーは常に現在の時刻を使用します。

数値／時刻のフォーマットと応答構成の規則については、{baseDir}/references/templates.md を参照してください。