okx-cex-smartmoney

Query OKX Smart Money leaderboard traders, positions, and aggregated consensus signals via CLI.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/wandreandrade2018-maker/claude-config --skill okx-cex-smartmoney-wandreandrade2018-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: okx-cex-smartmoney
Source: https://github.com/wandreandrade2018-maker/claude-config/tree/main/.agents/skills/okx-cex-smartmoney
Command: npx skills add https://github.com/wandreandrade2018-maker/claude-config --skill okx-cex-smartmoney-wandreandrade2018-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @okx_ai/okx-trade-cli, and includes references (resource) components.

What problem does it solve? It gives you read-only access to OKX Smart Money analytics—leaderboard trader rankings, position tracking, trade history, and aggregated long/short consensus signals—without manually navigating the OKX app or website. ## Core Features & Use Cases - Trader Discovery & Analytics: Rank top traders by PnL, win rate, drawdown, and AUM; search traders by nickname; inspect their open positions, closed-position history, and order records. - Smart Money Signals: Get multi-coin or single-coin long/short ratios, capital flow, entry price distribution, and signal time-series trends aggregated from top traders. - Use Case: Ask "what are smart money trading right now?" to get the top-20 hottest instruments with long/short ratios and net notional flow, then drill into a specific trader's full position book and realized PnL track record. ## Quick Start Ask the assistant to show the smart money signal for BTC or to recommend top traders by 30-day PnL.

Frequently Asked Questions about okx-cex-smartmoney

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find top traders on OKX by win rate or PnL?

Run okx smartmoney traders-by-filter with numeric thresholds like --minWinRate 0.8, --minPnl 10000, or --maxDrawdown 0.1, plus --period and --sortBy. Results are paginated by authorId cursor and returned as JSON.

How do I get the smart money signal for BTC on OKX?

Run okx smartmoney signal-overview-by-filter --instCcyList BTC --json. It returns long/short ratios, weighted ratios, net notional flow, average entry prices, and trend deltas versus 1h, 24h, and 7d for the current hour.

Does OKX smart money data include coin-margined contracts?

No. All four signal commands aggregate USDT-margined and USDS-margined contracts only; coin-margined positions like BTC-USD-SWAP are silently excluded. Use smartmoney trader-positions --authorId to see a trader's full book including coin-margined exposure.

How do I look up a trader when I only know their nickname?

Run okx smartmoney search-trader --keyword <name> to get up to 10 matching top traders sorted by follower count. Then feed the returned authorId into performance-by-trader, trader-positions, or trader-orders-history.

Why does the OKX CLI return 401 or session expired errors?

The OAuth session has expired or no API-key profile exists. Check okx config show --json and okx auth status --json, then re-authenticate via the okx-cex-auth flow before retrying the command.

Can I use OKX smart money commands in demo mode?

No. Smart Money leaderboard data is live-only, so demo mode is not supported. API-key users should pass --profile with their live profile, while OAuth users need no flag since live is the default.