Back to Details

okx-cex-smartmoney

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OKX CEX Smart Money CLI

OKX CEX Smart Money CLI

Smart Money leaderboard, trader analytics, position tracking, and aggregated consensus signals.
Smart Money交易员排行榜、交易员分析、持仓跟踪以及聚合共识信号。

Preflight

前置准备

Before running any command, follow 
../_shared/preflight.md
. Use 
metadata.version
from this file's frontmatter as the reference for Step 2.
运行任何命令前，请遵循
../_shared/preflight.md
中的指引。使用此文件前置内容中的
metadata.version
作为步骤2的参考版本。

Prerequisites

前提条件

  1. Install 
    okx
    CLI:
    bash
    npm install -g @okx_ai/okx-trade-cli
  2. Configure credentials:
    bash
    okx config add-profile AK=<your_api_key> SK=<your_secret_key> PP=<your_passphrase> name=live
# or interactive wizard:
okx config init
  3. Verify: 
    okx --profile live smartmoney traders --limit 5
  1. 安装
    okx
    CLI工具：
    bash
    npm install -g @okx_ai/okx-trade-cli
  2. 配置凭证：
    bash
    okx config add-profile AK=<your_api_key> SK=<your_secret_key> PP=<your_passphrase> name=live
# 或使用交互式向导：
okx config init
  3. 验证：执行
    okx --profile live smartmoney traders --limit 5

Credential & Profile Check

凭证与配置文件检查

Run 
okx config show
before any authenticated command.
  • Error or no configuration → stop, guide user to run 
    okx config init
    , wait for completion.
  • Credentials configured → proceed.
On 401 errors: stop immediately, tell the user their credentials may be invalid or expired, guide them to update 
~/.okx/config.toml
(do NOT ask them to paste credentials into chat), then verify with 
okx config show
and retry.
执行任何需要认证的命令前，请运行
okx config show
。
  • 若出现错误或无配置 → 停止操作，引导用户运行
    okx config init
    ，等待配置完成。
  • 凭证已配置 → 继续操作。
**遇到401错误时：**立即停止操作，告知用户其凭证可能无效或已过期，引导他们更新
~/.okx/config.toml
（请勿要求用户在聊天框中粘贴凭证），然后通过
okx config show
验证并重试。

Skill Routing

技能路由

User intentRoute to skill
Market prices, tickers, candles
okx-cex-market
Spot / swap / futures / options orders
okx-cex-trade
Account balance, positions, transfers
okx-cex-portfolio
Grid / DCA trading bots
okx-cex-bot
Simple Earn, On-chain Earn, DCD
okx-cex-earn
Smart Money leaderboard, signals, trader analyticsThis skill
用户意图路由至技能
市场价格、行情 ticker、K线
okx-cex-market
现货/永续合约/期货/期权订单
okx-cex-trade
账户余额、持仓、转账
okx-cex-portfolio
网格/DCA交易机器人
okx-cex-bot
Simple Earn、链上赚币、DCD
okx-cex-earn
Smart Money交易员排行榜、信号、交易员分析本技能

Command Index (5 commands, all read-only)

命令索引（5个命令，均为只读）

Trader Data

交易员数据

CommandTypeAuthDescription
smartmoney traders
READRequiredList/filter traders from leaderboard
smartmoney trader --authorId <id>
READRequiredTrader full portrait (profile + positions + trades)
smartmoney overview [--ts <ms>|--dataVersion <ver>]
READRequiredMulti-currency smart money overview (prefer --ts)
命令类型认证要求描述
smartmoney traders
只读需要列出/筛选排行榜中的交易员
smartmoney trader --authorId <id>
只读需要交易员完整画像（资料+持仓+交易记录）
smartmoney overview [--ts <ms>|--dataVersion <ver>]
只读需要多币种Smart Money总览（优先使用--ts参数）

Signal Data

信号数据

CommandTypeAuthDescription
smartmoney signal [--ts <ms>|--dataVersion <ver>]
READRequiredSingle-currency aggregated consensus signal (prefer --ts)
smartmoney signal-history --instId <id> [--ts <ms>|--dataVersion <ver>]
READRequiredSignal history timeline for trend analysis (prefer --ts)
Note: Prefer 
--ts
(e.g. 
--ts $(date +%s)000
for latest snapshot) for overview / signal / signal-history; 
--dataVersion
is an alternative for replaying a prior snapshot. At least one of the two must be provided; if both are sent, 
--ts
wins.
For full command syntax and parameters, read 
{baseDir}/references/trader-commands.md
and 
{baseDir}/references/signal-commands.md
.
命令类型认证要求描述
smartmoney signal [--ts <ms>|--dataVersion <ver>]
只读需要单币种聚合共识信号（优先使用--ts参数）
smartmoney signal-history --instId <id> [--ts <ms>|--dataVersion <ver>]
只读需要信号历史时间线，用于趋势分析（优先使用--ts参数）
注意： 查询总览/信号/信号历史时优先使用
--ts
参数（例如：
--ts $(date +%s)000
获取最新快照）；
--dataVersion
是用于回放历史快照的备选参数。必须提供其中一个参数；若同时提供，
--ts
参数优先级更高。
如需完整命令语法及参数说明，请查阅
{baseDir}/references/trader-commands.md
和
{baseDir}/references/signal-commands.md
。

Operation Flow

操作流程

Step 0 — Credential & Profile Check

步骤0 — 凭证与配置文件检查

Before any command: see Credential & Profile Check. Always use 
--profile live
silently.
执行任何命令前：请参考凭证与配置文件检查部分。默认自动添加
--profile live
参数。

Step 1 — Identify intent

步骤1 — 识别用户意图

Trader discovery / ranking:
  • "推荐交易员" / "top traders" / "牛人榜" → 
    smartmoney traders
    with sorting/filtering. See 
    {baseDir}/references/trader-commands.md
    .
  • "看看某个交易员" / "trader detail" → 
    smartmoney trader --authorId <id>
    . See 
    {baseDir}/references/trader-commands.md
    . Signal analysis:
  • "BTC 聪明钱信号" / "smart money signal for BTC" → 
    smartmoney signal
    . See 
    {baseDir}/references/signal-commands.md
    .
  • "聪明钱总览" / "smart money overview" → 
    smartmoney overview
    . See 
    {baseDir}/references/signal-commands.md
    .
  • "信号趋势" / "signal trend over time" → 
    smartmoney signal-history
    . See 
    {baseDir}/references/signal-commands.md
    .
交易员发现/排行：
  • "推荐交易员" / "top traders" / "牛人榜" → 使用带排序/筛选参数的
    smartmoney traders
    命令。详情请查阅
    {baseDir}/references/trader-commands.md
    。
  • "查看某个交易员详情" / "trader detail" → 使用
    smartmoney trader --authorId <id>
    命令。详情请查阅
    {baseDir}/references/trader-commands.md
    。 信号分析：
  • "BTC 聪明钱信号" / "smart money signal for BTC" → 使用
    smartmoney signal
    命令。详情请查阅
    {baseDir}/references/signal-commands.md
    。
  • "聪明钱总览" / "smart money overview" → 使用
    smartmoney overview
    命令。详情请查阅
    {baseDir}/references/signal-commands.md
    。
  • "信号趋势" / "signal trend over time" → 使用
    smartmoney signal-history
    命令。详情请查阅
    {baseDir}/references/signal-commands.md
    。

Step 2 — Execute and present

步骤2 — 执行并展示结果

All commands are READ-only — no confirmation needed. Always pass 
--json
and render results as Markdown tables.
For multi-step workflows (recommend traders then drill down, signal analysis with context), read 
{baseDir}/references/workflows.md
.
所有命令均为只读操作 — 无需确认。执行时需添加
--json
参数，并将结果渲染为Markdown表格。
如需多步骤工作流（如先推荐交易员再查看详情、结合上下文进行信号分析），请查阅
{baseDir}/references/workflows.md
。

Global Notes

全局注意事项

  • Security: Never ask users to paste API keys or secrets into chat.
  • Output: Always pass 
    --json
    to list/query commands and render results as a Markdown table — never paste raw terminal output.
  • Network errors: If commands fail with a connection error, prompt user to check VPN: 
    curl -I https://www.okx.com
  • Language: Always respond in the user's language.
  • Signal availability: Signal commands (overview, signal, signal-history) require either 
    --ts
    (preferred — use 
    $(date +%s)000
    for latest) or 
    --dataVersion
    (for historical snapshot replay). If both are sent, 
    --ts
    wins.
For number/time formatting and response structure conventions, read 
{baseDir}/references/templates.md
.
  • 安全： 切勿要求用户在聊天框中粘贴API密钥或机密信息。
  • 输出： 执行列表/查询命令时务必添加
    --json
    参数，并将结果渲染为Markdown表格 — 请勿直接粘贴原始终端输出。
  • 网络错误： 若命令因连接错误失败，请提示用户检查VPN：执行
    curl -I https://www.okx.com
  • 语言： 始终使用用户的语言进行回复。
  • 信号可用性： 信号类命令（总览、信号、信号历史）需要
    --ts
    参数（优先使用，
    $(date +%s)000
    可获取最新数据）或
    --dataVersion
    参数（用于回放历史快照）。若同时提供两个参数，
    --ts
    参数优先级更高。
如需数字/时间格式及响应结构规范，请查阅
{baseDir}/references/templates.md
。