okx-cex-market

OKX CEX Market Data CLI

コンプライアンスに関する通知：このスキルが提供するのは、生の市場データのみです。戦略、推奨、最適化のロジックは組み込まれていません。すべての指標の出力は客観的な数値であり、その解釈と取引の判断はユーザーのみに委ねられます。

OKX の公開市場データ：価格、オーダーブック、ローソク足、資金調達率、未決済建玉、銘柄情報、テクニカル指標。すべてのコマンドは読み取り専用で、API 認証情報は不要です。

スキルの振り分け

• 市場データ／指標 → okx-cex-market（このスキル）
• 口座残高／ポジション → okx-cex-portfolio
• 注文の発注／キャンセル → okx-cex-trade
• イベント契約として方向性の見通しに基づいて取引する → okx-cex-trade
• 市場センチメント／最も強気・弱気なコイン → okx-sentiment-tracker
• グリッド／DCA ボット → okx-cex-bot

事前確認

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

インストール

npm install -g @okx_ai/okx-trade-cli
okx market ticker BTC-USDT   # verify

市場データコマンドは、デモモードとライブモードのどちらでも同じ公開データを返します。API 認証情報は不要です。ユーザーのプロファイルで demo=true が設定されていて、ライブデータの状況を確認したい場合は、--live を使用してライブモードであることを確認できます（公開市場データには影響しませんが、環境が明確になります）。ユーザーの問い合わせに関係する場合は、現在の環境（デモまたはライブ）を必ず伝えてください。市場関連コマンドの実行前に確認を取る必要はありません。コマンドに --json を追加すると、OKX API v5 の生のレスポンスを取得できます。--env を追加すると、出力を {"env", "profile", "data"} の形式でラップできます。

---

コマンド一覧

#	コマンド	説明
1	okx market ticker <instId>	最終価格、24 時間の高値／安値／出来高／変動率
2	okx market tickers <instType>	SPOT／SWAP／FUTURES／OPTION の全ティッカー
3	okx market instruments --instType <type> [--instId <id>] [--uly <uly>] [--instFamily <fam>] [--seriesId <id>]	取引商品（instId、ctVal、lotSz、minSz、tickSz、state）の一覧。OPTION では --uly または --instFamily が必要です。EVENTS では --seriesId が必要です
4	okx market orderbook <instId> [--sz <n>]	オーダーブックの売り板／買い板（各サイドのデフォルトは上位 5 件、最大 400 件）
5	okx market candles <instId> [--bar <bar>] [--limit <n>] [--after <ts>] [--before <ts>]	OHLCV ローソク足（デフォルトは --bar 1m）。2021 年までさかのぼるデータには、履歴エンドポイントへ自動的にルーティングします。--after は過去方向、--before は未来方向へのページネーションに使用します
6	okx market index-candles <instId> [--bar <bar>] [--limit <n>] [--history]	インデックス OHLCV（BTC-USDT ではなく BTC-USD を使用）
7	okx market funding-rate <instId> [--history] [--limit <n>]	現在または過去の資金調達率（SWAP のみ）
8	okx market trades <instId> [--limit <n>]	最近の公開取引
9	okx market mark-price --instType <type> [--instId <id>]	マーク価格（SWAP／FUTURES／OPTION）
10	okx market index-ticker [--instId <id>] [--quoteCcy <ccy>]	インデックス価格（例：BTC-USD）
11	okx market price-limit <instId>	上限／下限価格（SWAP／FUTURES のみ）
12	okx market open-interest --instType <type> [--instId <id>]	コントラクト数および基軸通貨での未決済建玉
13	okx market instruments-by-category --instCategory <3|4|5|6|7>	資産カテゴリー別に取引商品を検索：3=株式トークン（AAPL/TSLA）、4=金属（金／銀）、5=商品（石油／ガス）、6=外国為替（EUR/USD）、7=債券
13†	okx market stock-tokens	非推奨 — 代わりに instruments-by-category --instCategory 3 を使用してください
14	okx market filter --instType <SPOT|SWAP|FUTURES> [--sortBy <field>] [--sortOrder <asc|desc>] [--limit <n>] [--baseCcy <ccy>] [--quoteCcy <ccy>] [--settleCcy <ccy>] [--instFamily <fam>] [--ctType <linear|inverse>] [--minLast <n>] [--maxLast <n>] [--minChg24hPct <n>] [--maxChg24hPct <n>] [--minMarketCapUsd <n>] [--maxMarketCapUsd <n>] [--minVolUsd24h <n>] [--maxVolUsd24h <n>] [--minFundingRate <n>] [--maxFundingRate <n>] [--minOiUsd <n>] [--maxOiUsd <n>]	多次元の条件（価格、出来高、OI、資金調達率、時価総額）で取引商品をスクリーニング／ランキングします。一致する取引商品のランキング表と Total: N を出力します（一致するものがない場合のみ No results を出力）。生の OKX API v5 レスポンスを取得するには --json を追加します（構造は変更されません）。
15	okx market oi-history <instId> [--bar <5m|15m|1H|4H|1D>] [--limit <n>] [--ts <ms>]	単一の取引商品の OI 履歴時系列と、各バー間の変動
16	okx market oi-change --instType <SWAP|FUTURES> [--bar <5m|15m|1H|4H|1D>] [--sortBy <field>] [--sortOrder <asc|desc>] [--limit <n>] [--minOiUsd <n>] [--minVolUsd24h <n>] [--minAbsOiDeltaPct <n>]	OI の変動が最も大きい取引商品を検索（蓄積／分配スキャナー）
17	okx market indicator list	サポートされているインジケーター名と説明の一覧
18	okx market indicator <indicator> <instId> [--bar] [--params] [--list] [--limit] [--backtest-time]	テクニカルインジケーターの値。期間ベースのインジケーター（ema/ma/wma/rsi/macd/bb/…）では、--params を省略すると CLI が適切なデフォルト期間を適用するため、パラメーターを指定しなくても値が表示されます（例：EMA/RSI → 14、MACD → 12,26,9、BB → 20,2）。明示的に指定した --params が常に優先されます。値が返されない場合、CLI は目に見えるヒント（try --params …）を表示し、何も通知せずに終わることはありません。
19	okx market pair-spread <instIdA> <instIdB> [--bar <5m|15m>] [--window <window>] [--backtest-time <ms>]	ルックバック期間におけるスプレッド統計（絶対値と比率：平均／標準偏差／中央値／最小値／最大値）。バックテストモードをサポートします

---

操作フロー

Step 1 — データの種類を特定して参照を読み込む

ユーザーの意図	読み込む参照
価格、ローソク足、オーダーブック、最近の取引	{baseDir}/references/price-data-commands.md
テクニカル指標（RSI、MACD、EMA、BB、KDJ、SuperTrend、AHR999、Rainbow など）	{baseDir}/references/indicator-commands.md
資金調達率、マーク価格、建玉、価格制限、インデックスティッカー	{baseDir}/references/derivatives-commands.md
銘柄のスクリーニング／ランキング、値上がり・値下がり上位、高建玉・高出来高のコントラクトの検索	okx market filter を直接使用
単一銘柄の建玉履歴の時系列	okx market oi-history を直接使用
建玉変化のスキャナー、大きな建玉変動があるコントラクトの検索	okx market oi-change を直接使用
通貨ペアのスプレッド統計、平均回帰／ペアトレードのポジションサイズ算出	okx market pair-spread を直接使用
銘柄の一覧表示、株式トークンの検索、金属／商品／外国為替／債券の検索、オプションの instId の検索	{baseDir}/references/instrument-commands.md
複数ステップまたはスキル横断のワークフロー、MCP ツール名	{baseDir}/references/workflows.md

イベントコントラクトはこのスキルでは扱いません。

ユーザーの質問	対応
資産がどちらに動いているか — 「BTC は上がっていますか」「15m のトレンドはどうですか」	ローソク足／指標を使ってここで回答
方向と、取引できるかどうかの両方	まずここでデータに関する部分に回答し、取引に関する部分は okx-cex-trade を案内
イベントコントラクトの取引 — 「…に YES／NO を買う」	okx-cex-trade に案内し、ここでは対応しない

イベントコントラクトの代わりに、別の商品を提示してはいけません。パーペチュアルでも、先物ポジションでも、依頼されたコントラクトとして提示する市場データでもいけません。 okx-cex-trade を読み込めない場合は、その旨を伝えて終了してください。

Step 2 — すぐにコマンドを実行する

すべての市場データコマンドは読み取り専用のため、確認は不要です。

Step 3 — 書き込みなし、検証も不要

このスキルのすべてのコマンドは読み取り専用です。

---

エッジケース

• instId の形式：SPOT BTC-USDT · SWAP BTC-USDT-SWAP · FUTURES BTC-USDT-250328 · OPTION BTC-USD-250328-95000-C · Index BTC-USD · Stock token TSLA-USDT-SWAP · Metals/Commodities/Forex/Bonds：まず instruments-by-category を使用して有効な instId を確認してください
• OPTION の一覧表示：instruments --instType OPTION には --uly BTC-USD または --instFamily BTC-USD が必要です。不明な場合は、まず open-interest --instType OPTION を実行して有効な instId を確認してください
• EVENTS の一覧表示：instruments --instType EVENTS には --seriesId（例：--seriesId BTC-ABOVE-DAILY）が必要です。まず okx event series を実行して有効なシリーズ ID を確認してください
• funding-rate / price-limit：SWAP のみ · mark-price：SWAP / FUTURES / OPTION のみ
• ローソク足の --bar：大文字を使用してください — 1h ではなく 1H。--after <ts> を使用すると過去のデータ（2021 年まで）をページネーションで取得できます。index-candles は、より長期間の履歴を取得する --history に対応しています
• ⚠️ 履歴データの範囲が広い場合：--after/--before を指定して取得する前に、ローソク足の件数を time_range_ms / bar_interval_ms で見積もってください。見積もりが 500 件を超える場合は、処理を進める前に見積もり件数をユーザーに伝え、確認を求めてください。これにより、コンテキストウィンドウが予告なく埋まるのを防げます
• indicator の --bar：1D ではなく 1Dutc、1W ではなく 1Wutc を使用します。ローソク足の bar 値とは異なります
• market filter の sortBy 値：last chg24hPct marketCapUsd volUsd24h fundingRate oiUsd listTime — デフォルトは volUsd24h
• market filter の ctType：linear または inverse（SWAP/FUTURES のみ）。SPOT では省略してください
• market filter の quoteCcy：カンマ区切りのリストに対応しています。例：--quoteCcy USDT,USDC
• market filter の SPOT と quoteCcy：--instType SPOT の場合、API はすべての quote 通貨（USDT、USDC、BTC、ETH など）の銘柄を混在した状態で返します。そのため、ソート順が乱れ、結果が膨らみます。ユーザーがほかの quote 通貨を明示的に要求しない限り、デフォルトで必ず --quoteCcy USDT を指定してください
• market filter の chg24hPct：値はパーセント単位です — --minChg24hPct -5 は -5%、--maxChg24hPct 10 は 10% を意味します
• market oi-history の ts：Unix ミリ秒のタイムスタンプです。過去データのページネーションでは、この値以下の ts を持つバーが返されます
• market oi-history / oi-change の bar：有効な値は 5m 15m 1H 4H 1D — デフォルトは 1H です。サーバーは大文字・小文字の違いを許容します（1h == 1H）が、標準の表記を使用してください
• market oi-history の limit：1～500（デフォルトは 50）
• market oi-change の instType：SWAP または FUTURES のみ対応しています（SPOT は非対応）
• market oi-change の minAbsOiDeltaPct：OI の変化率の絶対値でフィルタリングします — 1.0 を指定すると、|oiDeltaPct| ≥ 1% の行のみが残ります
• market oi-change の sortBy 値：oiUsd oiDeltaUsd oiDeltaPct absOiDeltaPct volUsd24h fundingRate last — デフォルトは oiDeltaPct（符号付き）です。変化の方向にかかわらず |oiDeltaPct| の大きさで順位付けするには、absOiDeltaPct を使用してください
• market oi-change の limit：1～100（デフォルトは 20）。100 件を超えるデータを取得する場合は、instId ごとに oi-history を取得してください
• indicator の --bar 有効値：3m 5m 15m 1H 4H 12Hutc 1Dutc 3Dutc 1Wutc — indicator では 1m はサポートされていません（1 分足データには candles を使用してください）
• indicator の --limit：1～100（過去の系列を要求する returnList 使用時のみ有効）
• indicator の引数順序：instId より前に indicator 名を指定します — okx market indicator rsi BTC-USDT
• indicator の --params：スペースを入れず、カンマ区切りで指定します — --params 5,20。期間ベースの indicator（ema/ma/wma/rsi/macd/bb/…）で --params を省略すると、CLI はデフォルトの期間（EMA/MA/WMA/RSI → 14、MACD → 12,26,9、BB → 20,2）を代入するため、表が空ではなくデータが入力されます。デフォルト値を上書きするには、--params を明示的に指定してください。（CLI のみの利便機能です — MCP の market_get_indicator 生データ経路では、引き続き明示的な paramList が必要です。）
• indicator の値が返されない場合：CLI は何も出力しないことはありません。クエリで値が取得できない場合（例：期間を必要としない indicator、またはデフォルト値のない期間ベースの indicator）、次のヒントを表示します：No indicator values returned. This indicator may require a period — try --params (e.g. --params 14).
• BTC 専用 indicator：ahr999、rainbow — BTC-USDT のみ
• 不明な indicator 名：API 呼び出し前に、類似する名前の候補を含む ValidationError を返します。有効な名前をすべて確認するには、market_list_indicators / okx market indicator list を使用してください
• Stock token の取引時間：米国株は月～金の 09:30～16:00 ET 頃に取引されます。取引を行う前にライブ価格を確認してください
• データが返されない場合：銘柄が上場廃止になっている可能性があります — okx market instruments で確認してください
• boll は bb のエイリアスです

全般的な注意事項

• このスキルのどのコマンドでも API キーは必要ありません
• レート制限：IP あたり 2 秒間に 20 リクエスト
• ローソク足データは新しい順に並んでいます
• vol24h はベース通貨単位です（例：BTC-USDT の場合は BTC）
• CLI 経由での市場データの結果には、--demo／--live と --profile は影響しません（パブリックエンドポイントを使用）。これらはアクティブな取引環境のコンテキストを決定するだけです