---
id: gh-okx-cex-smartmoney
name: "okx-cex-smartmoney"
url: https://skills.yangsir.net/skill/gh-okx-cex-smartmoney
author: okx
domain: investment
tags: ["crypto-trading", "smart-money", "trader-analytics", "market-sentiment", "okx"]
install_count: 1800
rating: 4.30 (120 reviews)
github: https://github.com/okx/agent-skills/tree/master/skills/okx-cex-smartmoney
---

# okx-cex-smartmoney

> OKX 聪明钱分析工具，追踪顶尖交易员持仓、交易记录和收益，获取聚合信号与历史数据。快速洞察市场情绪和资金流向，辅助投资决策。

**Stats**: 1,800 installs · 4.3/5 (120 reviews)

## Before / After 对比

### 获取聪明钱洞察所需时间

**Before**:

手动收集和分析多个平台上的顶尖交易员数据、持仓和交易信号，耗时且易错，难以快速形成投资决策。

**After**:

通过自动化工具，即时获取 OKX 聪明钱总览、交易员排行榜和实时信号，大幅提升市场分析效率和决策速度。

| Metric | Before | After | Change |
|---|---|---|---|
| 分析时间 | 240分钟 | 5分钟 | -97.9% |

## Readme

# 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`](../_shared/preflight.md).
Use `metadata.version` from this file's frontmatter as the reference for Step 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`

---

## 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 <id>` | READ | Required | Trader full portrait (profile + positions + trades) |
| `smartmoney overview [--ts <ms>\|--dataVersion <ver>]` | READ | Required | Multi-currency smart money overview (prefer --ts) |

### Signal Data

| Command | Type | Auth | Description |
|---|---|---|---|
| `smartmoney signal [--ts <ms>\|--dataVersion <ver>]` | READ | Required | Single-currency aggregated consensus signal (prefer --ts) |
| `smartmoney signal-history --instId <id> [--ts <ms>\|--dataVersion <ver>]` | 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](#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 <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`.

### 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`.


---
*Source: https://skills.yangsir.net/skill/gh-okx-cex-smartmoney*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-okx-cex-smartmoney/markdown*