OKX CEX Smart Money CLI
Smart Money leaderboard, trader analytics, position tracking, and aggregated consensus signals.
Preflight
Before running any command, follow
../_shared/preflight.md
.
Use
metadata.version
from this file's frontmatter as the reference for Step 2.
Prerequisites
Install
okx
CLI:
npm
install
-g
@okx_ai/okx-trade-cli
Configure credentials:
okx config add-profile
AK
=
<
your_api_key
SK
<
your_secret_key
PP
<
your_passphrase
name
live
or interactive wizard:
okx config init
Verify:
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.
Skill Routing
User intent
Route 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 analytics
This skill
Command Index (5 commands, all read-only)
Trader Data
Command
Type
Auth
Description
smartmoney traders
READ
Required
List/filter traders from leaderboard
smartmoney trader --authorId
READ
Required
Trader full portrait (profile + positions + trades)
smartmoney overview [--ts |--dataVersion ]
READ
Required
Multi-currency smart money overview (prefer --ts)
Signal Data
Command
Type
Auth
Description
smartmoney signal [--ts |--dataVersion ]
READ
Required
Single-currency aggregated consensus signal (prefer --ts)
smartmoney signal-history --instId [--ts |--dataVersion ]
READ
Required
Signal 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
.
Operation Flow
Step 0 — Credential & Profile Check
Before any command: see
Credential & Profile Check
. Always use
--profile live
silently.
Step 1 — Identify intent
Trader discovery / ranking:
"推荐交易员" / "top traders" / "牛人榜" →
smartmoney traders
with sorting/filtering. See
{baseDir}/references/trader-commands.md
.
"看看某个交易员" / "trader detail" →
smartmoney trader --authorId
. 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
.
Step 2 — Execute and present
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
.
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
.