skills.rest
nickthelegend
nickthelegendCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

okx-cex-smartmoney

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

Updated Aug 21, 2026
Search Tags:#cli#okx#smart money#crypto signals#position tracking#trader leaderboard#long short ratio
One-click install
npx skills add https://github.com/nickthelegend/xorr-monorepo --skill okx-cex-smartmoney-nickthelegend
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: okx-cex-smartmoney
Source: https://github.com/nickthelegend/xorr-monorepo/tree/main/.agents/skills/okx-cex-smartmoney
Command: npx skills add https://github.com/nickthelegend/xorr-monorepo --skill okx-cex-smartmoney-nickthelegend

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It gives agents read-only access to OKX Smart Money analytics — leaderboard trader rankings, individual trader positions and trade history, and aggregated long/short consensus signals — without manually calling the OKX journal API. ## Core Features & Use Cases - Trader discovery and analytics: Rank leaderboard traders by PnL, win rate, drawdown, and AUM; search traders by nickname; inspect current positions, closed-position history, and order/fill records per trader. - Consensus signal analysis: Aggregate long/short ratios, capital flow, entry prices, and win rates across smart money pools for specific coins or the top-N hottest instruments, with hourly or daily trend time-series. - Use Case: Ask "what are smart money trading right now?" to get the top-20 most-watched instruments with long/short ratios and net notional, then drill into a specific trader's realized PnL track record before deciding to follow them. ## Quick Start Ask the agent to show the top smart money traders by 30-day PnL and their current BTC consensus signal.

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 thresholds like --minWinRate 0.8, --minPnl 10000, or --maxDrawdown 0.1, plus --period and --sortBy. Results are paginated by authorId cursor via --after and --limit.

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, net notional, weighted entry prices, and trend deltas versus 1h, 24h, and 7d for the current UTC hour.

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

Use okx smartmoney search-trader --keyword <name> to resolve the nickname to up to 10 matching Top Traders sorted by follower count. Then pass the returned authorId to performance-by-trader, trader-positions, or trader-orders-history.

Does the smart money signal include coin-margined contracts?▼

No. All four signal commands aggregate only USDT-margined and USDS-margined contracts. Coin-margined positions like BTC-USD-SWAP are silently excluded, so check trader-positions for a trader's full book.

Why does the smartmoney command fail with a 401 or session expired error?▼

The okx CLI is not authenticated. Run okx config show --json and okx auth status --json to check credentials, then complete login via okx config init or the okx-cex-auth flow before retrying.

Can I see a trader's historical closed positions and realized PnL?▼

Yes. Run okx smartmoney trader-positions-history --authorId <id> --limit 50 to get closed positions with realizedPnl, pnlRatio, and closeType. Paginate further pages using the nextAfter cursor as --after.

Related Skills

Explore More Finance & Accounting Skills→
dex-originaldex-original
100

okx-cex-portfolio

Retrieve OKX account balances, positions, and P&L via okx-trade-cli.

Official
Advanced
dex-originaldex-original
100

okx-cex-smartmoney

Retrieve OKX Smart Money leaderboard traders, positions, and consensus signals.

Official
Advanced
philipcoller-777philipcoller-777

okx-market

Fetch real-time and historical cryptocurrency market data from OKX public V5 REST API.

Community
Intermediate
datagridSolutiondatagridSolution

dividend-tracker

Track dividend events and deliver ex-date alerts with automated reinvestment workflows.

Official
Intermediate