CLI Reference

May 18, 2026 · View on GitHub

CLI vs MCP tool names

Subcommands use spaces (okx swap algo place, okx bot grid create), not hyphens. AI agents see the same features under underscored MCP tool names (swap_place_algo_order, bot_grid_create_order). Do NOT convert an MCP tool identifier into a hyphen-joined CLI command — okx swap place-algo is not a valid command and will be rejected with Unknown command. Per-module mapping tables live in skills/okx-cex-trade/references/<module>-commands.md.

Installation

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

Global Options

Option	Description
`--profile <name>`	Choose profile from `~/.okx/config.toml`
`--demo`	Use simulated trading (demo) mode
`--json`	Raw JSON output (useful for scripting with `jq`)
`--help`	Show help

# Pipe to jq
okx account balance --json | jq '.[] | {ccy: .ccy, eq: .eq}'

Exit Codes

Code	Meaning
`0`	Success
`1`	Any failure — network error, authentication error, argument validation error, or OKX business rejection (e.g. insufficient balance, invalid instrument)

Exit code 1 indicates failure.

Partial batch failure: if any item in a batch request has sCode != "0", the command exits with code 1. Agents and scripts should inspect the JSON output to identify which individual items failed.

# Safe to use in scripts — exit code 1 if order was rejected for any reason
okx spot place --instId BTC-USDT --side buy --ordType market --sz 100 --json
if [ $? -ne 0 ]; then
  echo "Order failed"
fi

# Batch: exit code 1 even if only some orders fail — check each item's sCode
okx spot batch place orders.json --json | jq '.[] | select(.sCode != "0")'

market — Market Data (no API key required)

okx market ticker BTC-USDT
okx market tickers SPOT
okx market orderbook BTC-USDT --sz 5
okx market candles BTC-USDT --bar 1H --limit 10
okx market instruments --instType SWAP
okx market funding-rate BTC-USDT-SWAP
okx market funding-rate BTC-USDT-SWAP --history --limit 10
okx market mark-price --instType SWAP --instId BTC-USDT-SWAP
okx market trades BTC-USDT --limit 20
okx market index-ticker --instId BTC-USD
okx market price-limit BTC-USDT-SWAP
okx market open-interest --instType SWAP

# pair-spread — spread statistics between two instruments
okx market pair-spread BTC-USDT-SWAP ETH-USDT-SWAP
okx market pair-spread BTC-USDT-SWAP ETH-USDT-SWAP --bar 5m --window 4H
okx market pair-spread BTC-USDT-SWAP ETH-USDT-SWAP --backtest-time 1715000000000 --json

Supported candle intervals: 1m 3m 5m 15m 30m 1H 2H 4H 6H 12H 1D 1W 1M

account

okx account balance
okx account balance BTC,ETH
okx account asset-balance              # funding account balance
okx account positions
okx account bills
okx account bills --archive            # bills older than 7 days (up to 3 months)
okx account fees --instType SPOT
okx account config
okx account max-size --instId BTC-USDT-SWAP --tdMode cross
okx account max-withdrawal
okx account positions-history
okx account set-position-mode --posMode net_mode

spot — Spot Trading

okx spot orders
okx spot orders --instId BTC-USDT --history
okx spot get --instId BTC-USDT --ordId 123456
okx spot fills --instId BTC-USDT
okx spot place --instId BTC-USDT --side buy --ordType market --sz 100
okx spot place --instId BTC-USDT --side sell --ordType limit --sz 0.001 --px 70000
# With attached TP/SL
okx spot place --instId BTC-USDT --side buy --ordType limit --sz 0.001 --px 60000 \
  --tpTriggerPx 65000 --tpOrdPx 64900 --slTriggerPx 58000 --slOrdPx 57900
okx spot amend --instId BTC-USDT --ordId 123456 --newPx 68000
okx spot cancel BTC-USDT --ordId 123456

swap — Perpetual Contracts

okx swap positions
okx swap orders --history
okx swap get --instId BTC-USDT-SWAP --ordId 123456
okx swap fills --instId BTC-USDT-SWAP
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 --posSide long --tdMode cross
# With attached TP/SL
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 --posSide long --tdMode cross \
  --tpTriggerPx 100000 --tpOrdPx 99900 --slTriggerPx 85000 --slOrdPx 84900
okx swap cancel BTC-USDT-SWAP --ordId 123456
okx swap close --instId BTC-USDT-SWAP --mgnMode cross
okx swap leverage --instId BTC-USDT-SWAP --lever 10 --mgnMode cross
okx swap get-leverage --instId BTC-USDT-SWAP --mgnMode cross

futures — Delivery Contracts

okx futures orders
okx futures orders --history
okx futures positions
okx futures fills
okx futures place --instId BTC-USDT-250328 --side buy --ordType market --sz 1 --tdMode cross
# With attached TP/SL
okx futures place --instId BTC-USDT-250328 --side buy --ordType market --sz 1 --tdMode cross \
  --tpTriggerPx 100000 --tpOrdPx 99900 --slTriggerPx 85000 --slOrdPx 84900
okx futures cancel BTC-USDT-250328 --ordId 123456
okx futures get --instId BTC-USDT-250328 --ordId 123456

bot — Trading Bots

# ── Spot Grid (algoOrdType: grid) ─────────────────────────────────────────────
# List / query
okx bot grid orders --algoOrdType grid
okx bot grid orders --algoOrdType grid --history
okx bot grid orders --algoOrdType grid --instId BTC-USDT
okx bot grid details --algoOrdType grid --algoId <algoId>
okx bot grid sub-orders --algoOrdType grid --algoId <algoId>          # filled trades
okx bot grid sub-orders --algoOrdType grid --algoId <algoId> --live   # live orders

# Create spot grid — invest in quote currency (USDT)
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --quoteSz 100

# Create spot grid — invest in base currency (BTC)
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --baseSz 0.001

# Create spot grid — geometric spacing (runType 2)
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --quoteSz 100 --runType 2

# Stop spot grid (stopType: 1=sell all holdings (default), 2=keep holdings)
okx bot grid stop --algoId <algoId> --algoOrdType grid --instId BTC-USDT
okx bot grid stop --algoId <algoId> --algoOrdType grid --instId BTC-USDT --stopType 2

# ── Contract Grid (algoOrdType: contract_grid) ────────────────────────────────
# List / query
okx bot grid orders --algoOrdType contract_grid
okx bot grid orders --algoOrdType contract_grid --history
okx bot grid details --algoOrdType contract_grid --algoId <algoId>
okx bot grid sub-orders --algoOrdType contract_grid --algoId <algoId>

# Create contract grid — neutral direction, 3x leverage, 100 USDT margin
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction neutral --lever 3 --sz 100

# Create contract grid — long direction, 5x leverage, 100 USDT margin
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction long --lever 5 --sz 100

# Create contract grid — short direction, 3x leverage, 100 USDT margin
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction short --lever 3 --sz 100

# Create coin-margined contract grid — sz is in BTC (not USDT)
okx bot grid create --instId BTC-USD-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 20 \
  --direction long --lever 5 --sz 0.1

# Stop contract grid (stopType: 1=close position+stop (default), 2=keep position+stop)
okx bot grid stop --algoId <algoId> --algoOrdType contract_grid --instId BTC-USDT-SWAP
okx bot grid stop --algoId <algoId> --algoOrdType contract_grid --instId BTC-USDT-SWAP --stopType 2

# ── Moon Grid (algoOrdType: moon_grid) — list/query only ─────────────────────
okx bot grid orders --algoOrdType moon_grid
okx bot grid details --algoOrdType moon_grid --algoId <algoId>

# ── Contract DCA ──────────────────────────────────────────────────────────────
okx bot dca orders [--algoId <algoId>] [--instId <instId>]
okx bot dca orders --history
okx bot dca details --algoId <algoId>
okx bot dca sub-orders --algoId <algoId>
okx bot dca sub-orders --algoId <algoId> --cycleId <cycleId>

okx bot dca create \
  --instId BTC-USDT-SWAP --lever 3 --direction long \
  --initOrdAmt 100 --safetyOrdAmt 50 --maxSafetyOrds 3 \
  --pxSteps 0.03 --pxStepsMult 1 --volMult 1 --tpPct 0.03
# Note: safetyOrdAmt, pxSteps, pxStepsMult, volMult are required when maxSafetyOrds > 0

# With optional params (stop-loss, trigger strategy)
okx bot dca create \
  --instId BTC-USDT-SWAP --lever 3 --direction long \
  --initOrdAmt 100 --safetyOrdAmt 50 --maxSafetyOrds 3 \
  --pxSteps 0.03 --pxStepsMult 1 --volMult 1 \
  --tpPct 0.03 --slPct 0.15 --slMode market

okx bot dca stop --algoId <algoId>

smartmoney — Smart Money Analytics (read-only)

# ── Trader family ───────────────────────────────────────────────────────────
# Leaderboard ranking by pool conditions
okx smartmoney traders-by-filter --period 30 --sortBy pnl --limit 10
okx smartmoney traders-by-filter --minWinRate 0.8 --maxDrawdown 0.1 --period 30 --json

# PnL/win-rate profile for one or more authorIds (--sortBy + --period required; defaults pnl + 90)
okx smartmoney performance-by-trader --authorIds <id1>,<id2> --sortBy pnl --period 30

# Current open positions for one trader
okx smartmoney trader-positions --authorId <id>
okx smartmoney trader-positions --authorId <id> --instId BTC-USDT-SWAP

# Closed-position history (paginated by posId)
okx smartmoney trader-positions-history --authorId <id> --limit 50
okx smartmoney trader-positions-history --authorId <id> --after <posId> --limit 50

# Order/fill flow (paginated by ordId)
okx smartmoney trader-orders-history --authorId <id> --limit 50
okx smartmoney trader-orders-history --authorId <id> --instId BTC-USDT-SWAP --limit 50

# ── Signal / coin family ────────────────────────────────────────────────────
# Top-N most-watched-by-smart-money instruments — pool filter mode (current hour)
okx smartmoney signal-overview-by-filter --topInstruments 20
okx smartmoney signal-overview-by-filter --topInstruments 20 --pnlTier PNL_TOP20

# Single-asset signal — pool filter mode (current hour)
okx smartmoney signal-overview-by-filter --instCcyList BTC
okx smartmoney signal-overview-by-filter --instCcyList BTC --pnlTier PNL_TOP20 --winRateTier WR_GE_80

# Multi-asset signal — restricted to specific authorIds (current hour); --sortBy / --period drive capability metrics (defaults pnl / 7)
okx smartmoney signal-overview-by-trader --authorIds <id1>,<id2> --instCcyList BTC,ETH --sortBy pnl --period 7

# Single-asset signal time-series — pool filter, last 30 daily buckets ending at the current UTC hour
okx smartmoney signal-trend-by-filter --instCcy BTC --granularity 1d --limit 30

# Anchor at a specific hour: 10-digit yyyyMMddHH UTC
okx smartmoney signal-trend-by-filter --instCcy BTC --asOfTime 2026050100 --granularity 1d --limit 30

# Restricted to authorIds (authorIds-direct-lookup); --sortBy / --period exposed; capability tier filters not exposed
okx smartmoney signal-trend-by-trader --authorIds <id1>,<id2> --instCcy BTC --granularity 1h --limit 7 --sortBy pnl --period 7

Tier enums (signal family):

pnlTier: PNL_ANY / PNL_TOP50 / PNL_TOP20 / PNL_TOP5
winRateTier: WR_ANY / WR_GE_50 / WR_GE_80
maxDrawdownTier: MR_ANY / MR_LE_20 / MR_LE_50
aumTier: AUM_ANY / AUM_TOP50 / AUM_TOP20 / AUM_TOP5

Need a trader's full picture? Run performance-by-trader, trader-positions, and trader-orders-history in parallel — the old smartmoney trader composite command has been removed.

config

okx config show
okx config set default_profile live

setup — Configure MCP Clients

# Write MCP server entry into client config file
okx setup --client claude-desktop
okx setup --client cursor
okx setup --client windsurf
okx setup --client vscode          # writes .mcp.json in current directory
okx setup --client claude-code     # runs claude mcp add

# With specific profile and modules
okx setup --client claude-desktop --profile live --modules market,spot,account

Supported clients: claude-desktop cursor windsurf vscode claude-code

Also available directly as okx-trade-mcp setup --client <client> without installing the CLI.

CLI 命令参考（中文）

安装

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

全局选项

选项	说明
`--profile <name>`	指定 `~/.okx/config.toml` 中的 Profile
`--demo`	使用模拟盘模式
`--json`	原始 JSON 输出（便于配合 `jq` 脚本使用）
`--help`	显示帮助

# 配合 jq 使用
okx account balance --json | jq '.[] | {ccy: .ccy, eq: .eq}'

退出码

退出码	含义
`0`	成功
`1`	任何失败——网络错误、鉴权错误、参数校验错误，或 OKX 业务拒绝（如余额不足、合约不存在）

退出码 1 表示失败。

批量部分失败： 只要批量请求中_任意一笔_的 sCode != "0"，命令即以退出码 1 退出。Agent 和脚本应检查 JSON 输出，以确定哪些具体条目失败。

# 脚本中可安全使用——任何原因导致的下单失败都会返回退出码 1
okx spot place --instId BTC-USDT --side buy --ordType market --sz 100 --json
if [ $? -ne 0 ]; then
  echo "下单失败"
fi

# 批量：即使只有部分订单失败也会返回退出码 1——逐条检查 sCode
okx spot batch place orders.json --json | jq '.[] | select(.sCode != "0")'

market — 行情数据（无需 API Key）

okx market ticker BTC-USDT
okx market tickers SPOT
okx market orderbook BTC-USDT --sz 5
okx market candles BTC-USDT --bar 1H --limit 10
okx market instruments --instType SWAP
okx market funding-rate BTC-USDT-SWAP
okx market funding-rate BTC-USDT-SWAP --history --limit 10
okx market mark-price --instType SWAP --instId BTC-USDT-SWAP
okx market trades BTC-USDT --limit 20
okx market index-ticker --instId BTC-USD
okx market price-limit BTC-USDT-SWAP
okx market open-interest --instType SWAP

K线周期：1m 3m 5m 15m 30m 1H 2H 4H 6H 12H 1D 1W 1M

account — 账户

okx account balance
okx account balance BTC,ETH
okx account asset-balance              # 资金账户余额
okx account positions
okx account bills
okx account bills --archive            # 7天前账单（最多3个月）
okx account fees --instType SPOT
okx account config
okx account max-size --instId BTC-USDT-SWAP --tdMode cross
okx account max-withdrawal
okx account positions-history
okx account set-position-mode --posMode net_mode

spot — 现货交易

okx spot orders
okx spot orders --instId BTC-USDT --history
okx spot get --instId BTC-USDT --ordId 123456
okx spot fills --instId BTC-USDT
okx spot place --instId BTC-USDT --side buy --ordType market --sz 100
okx spot place --instId BTC-USDT --side sell --ordType limit --sz 0.001 --px 70000
# 附带止盈止损
okx spot place --instId BTC-USDT --side buy --ordType limit --sz 0.001 --px 60000 \
  --tpTriggerPx 65000 --tpOrdPx 64900 --slTriggerPx 58000 --slOrdPx 57900
okx spot amend --instId BTC-USDT --ordId 123456 --newPx 68000
okx spot cancel BTC-USDT --ordId 123456

swap — 永续合约

okx swap positions
okx swap orders --history
okx swap get --instId BTC-USDT-SWAP --ordId 123456
okx swap fills --instId BTC-USDT-SWAP
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 --posSide long --tdMode cross
# 附带止盈止损
okx swap place --instId BTC-USDT-SWAP --side buy --ordType market --sz 1 --posSide long --tdMode cross \
  --tpTriggerPx 100000 --tpOrdPx 99900 --slTriggerPx 85000 --slOrdPx 84900
okx swap cancel BTC-USDT-SWAP --ordId 123456
okx swap close --instId BTC-USDT-SWAP --mgnMode cross
okx swap leverage --instId BTC-USDT-SWAP --lever 10 --mgnMode cross
okx swap get-leverage --instId BTC-USDT-SWAP --mgnMode cross

futures — 交割合约

okx futures orders
okx futures orders --history
okx futures positions
okx futures fills
okx futures place --instId BTC-USDT-250328 --side buy --ordType market --sz 1 --tdMode cross
# 附带止盈止损
okx futures place --instId BTC-USDT-250328 --side buy --ordType market --sz 1 --tdMode cross \
  --tpTriggerPx 100000 --tpOrdPx 99900 --slTriggerPx 85000 --slOrdPx 84900
okx futures cancel BTC-USDT-250328 --ordId 123456
okx futures get --instId BTC-USDT-250328 --ordId 123456

bot — 交易机器人

# ── 现货网格（algoOrdType: grid）─────────────────────────────────────────────
# 查询
okx bot grid orders --algoOrdType grid
okx bot grid orders --algoOrdType grid --history
okx bot grid orders --algoOrdType grid --instId BTC-USDT
okx bot grid details --algoOrdType grid --algoId <algoId>
okx bot grid sub-orders --algoOrdType grid --algoId <algoId>          # 已成交子订单
okx bot grid sub-orders --algoOrdType grid --algoId <algoId> --live   # 挂单中子订单

# 创建现货网格 — 用计价货币（USDT）投入
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --quoteSz 100

# 创建现货网格 — 用基础货币（BTC）投入
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --baseSz 0.001

# 创建现货网格 — 等比间距（runType 2）
okx bot grid create --instId BTC-USDT --algoOrdType grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 --quoteSz 100 --runType 2

# 停止现货网格（stopType: 1=卖出全部持仓（默认）, 2=保留持仓）
okx bot grid stop --algoId <algoId> --algoOrdType grid --instId BTC-USDT
okx bot grid stop --algoId <algoId> --algoOrdType grid --instId BTC-USDT --stopType 2

# ── 合约网格（algoOrdType: contract_grid）────────────────────────────────────
# 查询
okx bot grid orders --algoOrdType contract_grid
okx bot grid orders --algoOrdType contract_grid --history
okx bot grid details --algoOrdType contract_grid --algoId <algoId>
okx bot grid sub-orders --algoOrdType contract_grid --algoId <algoId>

# 创建合约网格 — neutral 方向，3倍杠杆，100 USDT 保证金
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction neutral --lever 3 --sz 100

# 创建合约网格 — 做多，5倍杠杆，100 USDT 保证金
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction long --lever 5 --sz 100

# 创建合约网格 — 做空，3倍杠杆，100 USDT 保证金
okx bot grid create --instId BTC-USDT-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 10 \
  --direction short --lever 3 --sz 100

# 创建币本位合约网格 — sz 单位为 BTC（非 USDT）
okx bot grid create --instId BTC-USD-SWAP --algoOrdType contract_grid \
  --maxPx 100000 --minPx 80000 --gridNum 20 \
  --direction long --lever 5 --sz 0.1

# 停止合约网格（stopType: 1=平仓并停止（默认）, 2=保留仓位并停止）
okx bot grid stop --algoId <algoId> --algoOrdType contract_grid --instId BTC-USDT-SWAP
okx bot grid stop --algoId <algoId> --algoOrdType contract_grid --instId BTC-USDT-SWAP --stopType 2

# ── 月网格（algoOrdType: moon_grid）— 仅支持查询 ─────────────────────────────
okx bot grid orders --algoOrdType moon_grid
okx bot grid details --algoOrdType moon_grid --algoId <algoId>

# ── 合约 DCA ──────────────────────────────────────────────────────────────────
okx bot dca orders [--algoId <algoId>] [--instId <instId>]
okx bot dca orders --history
okx bot dca details --algoId <algoId>
okx bot dca sub-orders --algoId <algoId>
okx bot dca sub-orders --algoId <algoId> --cycleId <cycleId>

okx bot dca create \
  --instId BTC-USDT-SWAP --lever 3 --direction long \
  --initOrdAmt 100 --safetyOrdAmt 50 --maxSafetyOrds 3 \
  --pxSteps 0.03 --pxStepsMult 1 --volMult 1 --tpPct 0.03
# 注意：当 maxSafetyOrds > 0 时，safetyOrdAmt、pxSteps、pxStepsMult、volMult 为必填

# 带可选参数（止损、触发策略）
okx bot dca create \
  --instId BTC-USDT-SWAP --lever 3 --direction long \
  --initOrdAmt 100 --safetyOrdAmt 50 --maxSafetyOrds 3 \
  --pxSteps 0.03 --pxStepsMult 1 --volMult 1 \
  --tpPct 0.03 --slPct 0.15 --slMode market

okx bot dca stop --algoId <algoId>

smartmoney — 聪明钱分析（只读）

# ── Trader 家族 ─────────────────────────────────────────────────────────────
# 排行榜（按池筛选）
okx smartmoney traders-by-filter --period 30 --sortBy pnl --limit 10
okx smartmoney traders-by-filter --minWinRate 0.8 --maxDrawdown 0.1 --period 30 --json

# 指定 authorIds 的 PnL / 胜率画像
okx smartmoney performance-by-trader --authorIds <id1>,<id2> --period 30

# 单交易员当前持仓
okx smartmoney trader-positions --authorId <id>
okx smartmoney trader-positions --authorId <id> --instId BTC-USDT-SWAP

# 历史平仓（按 posId 游标分页）
okx smartmoney trader-positions-history --authorId <id> --limit 50
okx smartmoney trader-positions-history --authorId <id> --after <posId> --limit 50

# 订单 / 成交流水（按 ordId 游标分页）
okx smartmoney trader-orders-history --authorId <id> --limit 50
okx smartmoney trader-orders-history --authorId <id> --instId BTC-USDT-SWAP --limit 50

# ── Signal / coin 家族 ─────────────────────────────────────────────────────
# Top-N 聪明钱关注度最高的标的 —— 池过滤模式（当前小时）
okx smartmoney signal-overview-by-filter --topInstruments 20
okx smartmoney signal-overview-by-filter --topInstruments 20 --pnlTier PNL_TOP20

# 多币信号 —— 池过滤模式（当前小时）
okx smartmoney signal-overview-by-filter --instCcyList BTC
okx smartmoney signal-overview-by-filter --instCcyList BTC --pnlTier PNL_TOP20 --winRateTier WR_GE_80

# 多币信号 —— 限定指定 authorIds（当前小时）
okx smartmoney signal-overview-by-trader --authorIds <id1>,<id2> --instCcyList BTC,ETH

# 单币信号时间序列 —— 池过滤，最近 30 个日 K，锚定当前 UTC 整点
okx smartmoney signal-trend-by-filter --instCcy BTC --granularity 1d --limit 30

# 锚定指定整点（10 位 yyyyMMddHH UTC）
okx smartmoney signal-trend-by-filter --instCcy BTC --asOfTime 2026050100 --granularity 1d --limit 30

# 限定 authorIds（authorIds 直查;不暴露池过滤器,后端使用默认池配置）
okx smartmoney signal-trend-by-trader --authorIds <id1>,<id2> --instCcy BTC --limit 7

档位枚举（Signal 家族）：

pnlTier：PNL_ANY / PNL_TOP50 / PNL_TOP20 / PNL_TOP5
winRateTier：WR_ANY / WR_GE_50 / WR_GE_80
maxDrawdownTier：MR_ANY / MR_LE_20 / MR_LE_50
aumTier：AUM_ANY / AUM_TOP50 / AUM_TOP20 / AUM_TOP5

需要交易员完整画像？把 performance-by-trader / trader-positions / trader-orders-history 并发调用即可——旧的 smartmoney trader 复合命令已删除。

config — 配置

okx config show
okx config set default_profile live

setup — 配置 MCP 客户端

# 将 MCP Server 配置写入客户端配置文件
okx setup --client claude-desktop
okx setup --client cursor
okx setup --client windsurf
okx setup --client vscode          # 在当前目录写 .mcp.json
okx setup --client claude-code     # 调用 claude mcp add

# 指定 profile 和模块
okx setup --client claude-desktop --profile live --modules market,spot,account

支持的客户端：claude-desktop cursor windsurf vscode claude-code

不安装 CLI 也可以直接用 okx-trade-mcp setup --client <client>。