| name | okx-smart-money-tracker |
| description | Track profitable on-chain wallets (smart money) and execute follow trades via Agentic Wallet. Monitors whale activity on Solana and X Layer, filters by win rate and recency, runs security checks, and optionally auto-copies trades. Triggers: 'track smart money', 'follow whale trades', '聪明钱追踪', '跟单', 'whale alert', 'copy trade', 'what are whales buying', '大户在买什么', 'smart money signal', '跟聪明钱交易', 'show top traders', 'best traders on Solana/XLayer'. Do NOT use for: general DEX swaps (use okx-dex-swap); portfolio queries (use okx-wallet-portfolio); competition status (use okx-growth-competition); DApp-specific trades like Aave/Hyperliquid (use okx-dapp-discovery). |
| license | MIT |
| metadata | {"author":"community","version":"1.0.0","homepage":"https://github.com/KuaaMU/okx-smart-money-tracker","competition":"Agentic Trading Contest — Skill Quality Prize"} |
Smart Money Tracker
Track profitable on-chain wallets, analyze their trades, and optionally follow their positions via Agentic Wallet.
Why This Skill Exists
Retail traders lose money because they trade against informed participants. Smart money wallets — whales, MEV bots, KOL wallets, DeFi power users — consistently outperform. This skill identifies those wallets, monitors their activity in real-time, and lets you follow their trades with one command.
Data source: All market data, token info, and trade execution uses onchainOS CLI exclusively (dex-market, dex-token, swap execute). No external APIs.
Trigger Scenarios
Activate this skill when the user expresses ANY of these intents (English or Chinese):
Direct triggers (high confidence):
- "track smart money" / "追踪聪明钱"
- "follow whale trades" / "跟大户交易" / "跟单"
- "copy trade" / "复制交易"
- "what are whales buying" / "大户在买什么" / "聪明钱在买什么"
- "smart money signal" / "聪明钱信号"
- "show top traders" / "显示最佳交易者"
- "whale alert" / "大户异动"
- "find profitable wallets" / "找到盈利地址"
- "跟聪明钱交易" / "跟着大户买"
Indirect triggers (context-dependent):
- "who is buying [token]" / "谁在买 [代币]"
- "best traders on Solana/XLayer" / "Solana/XLayer 上最赚钱的地址"
- "monitor wallet [address]" / "监控地址"
- "recent whale activity" / "最近大户活动"
Do NOT trigger on:
- Single words: "whale", "money", "track" (too ambiguous)
- "swap tokens" / "兑换代币" → route to okx-dex-swap
- "show my portfolio" → route to okx-wallet-portfolio
- "join competition" → route to okx-growth-competition
Pre-flight Checks
Before running any command:
- Check wallet login:
onchainos wallet status. If loggedIn: false → tell user to login first (see okx-agentic-wallet Step 2).
- Check balance: Ensure user has sufficient balance if they want to execute follow trades (minimum $5 recommended for X Layer, $20 for Solana due to gas).
- Determine chain: Ask user which chain (Solana or X Layer). If unspecified, default to X Layer (zero gas fees, faster iteration).
Core Workflow
Step 1 — Discover Smart Money Addresses
onchainos dex-market address-tracker --chain <chain> --sort-type <type> --limit 20
Why this command: address-tracker returns the most active and profitable addresses on a chain, ranked by metrics like PnL, win rate, and volume. This is the foundation of smart money identification.
Sort types (use --sort-type to filter):
pnl — Highest realized profit (best for finding consistent earners)winRate — Highest win rate (best for finding reliable traders)volume — Highest trading volume (best for finding whales)
Recommended approach: Run with pnl sort first, then cross-reference with winRate to filter out lucky one-hit-wonders.
Filtering Logic (MUST follow)
After fetching the address list, apply these filters before presenting to the user:
| Filter | Threshold | Reason |
|---|
| Win rate | ≥ 60% | Below 60% = more luck than skill |
| Total trades | ≥ 10 | Below 10 = insufficient data |
| Recent activity | Last 7 days | Stale wallets are not actionable |
| Realized PnL | > $500 | Below $500 = noise, not signal |
Addresses passing ALL filters = Tier 1 Smart Money. Show these first.
Step 2 — Analyze Target Address Activity
For each Tier 1 address, fetch recent trades:
onchainos dex-market address-tracker --chain <chain> --address <addr> --limit 10
Why this command: Shows what the address has been buying/selling recently, with amounts and timestamps. This is the "signal" — what smart money is doing RIGHT NOW.
What to look for (prioritize in this order):
- Accumulation pattern: Same token bought 3+ times in 24h → strong conviction
- Large buy relative to portfolio: Buy > 20% of their known holdings → high conviction
- New token entry: First-time buy of a token they've never held → new thesis
- Fresh buys (< 24h): Most actionable for follow trades
Step 3 — Token Security Check
For each token from Step 2 signals, run a security scan:
onchainos dex-token advanced-info --chain <chain> --token-address <ca>
Why this command: Checks token safety before recommending a buy. Prevents following smart money into honeypots or rug pulls.
Risk gates (MUST check all):
| Check | Field | Pass Condition |
|---|
| Honeypot | isHoneyPot | Must be false |
| Risk level | riskLevel | Must be ≤ 2 (level 3+ = competition-ineligible + dangerous) |
| Liquidity | liquidity | Must be ≥ $10,000 |
| Token age | createTime | Warn if < 24 hours |
| Dev rug history | devRugPullTokenCount | Warn if > 0 |
| Tax rate | buyTaxRate / sellTaxRate | Warn if > 5% |
If any BLOCK condition fails (honeypot = true, risk level ≥ 3): DO NOT recommend this token. Inform user: "Signal from [address] on [token] blocked — security check failed (reason)."
If only WARN conditions fail (new token, high tax, dev rug history): Show warning, let user decide.
Step 4 — Generate Signal Report
Output the signal in a structured format (see Output Templates below). The report must include:
- Which smart money address made the trade
- Their historical win rate and PnL
- What token they bought, how much, when
- Security assessment result
- Recommended action
Step 5 — Execute Follow Trade (Optional)
Only if the user explicitly requests to follow. DO NOT auto-execute without confirmation.
onchainos swap execute \
--from <user's_base_token> \
--to <signal_token_address> \
--readable-amount <amount> \
--chain <chain> \
--wallet <user_address> \
[--slippage <pct>]
Why this command: Uses OKX DEX aggregator for best price across 500+ liquidity sources. The --wallet parameter ensures the trade broadcasts from the user's Agentic Wallet.
Parameters to set based on token type:
| Token Type | Slippage | Gas Level | Notes |
|---|
| Mainstream (ETH, SOL, major tokens) | auto (ref 0.5-1%) | average | High liquidity |
| Mid-cap | auto (ref 2-5%) | average | Moderate liquidity |
| Meme / Low-cap | auto (ref 5-20%) | fast | Low liquidity, speed matters |
After execution: Report the txHash and remind user this is a BROADCAST, not confirmed. Suggest checking explorer for final status.
Step 6 — Track Follow Performance
After executing a follow trade, create a tracking entry. When user asks "how are my follow trades doing":
- Fetch current token price:
onchainos swap quote --from <token> --to <base_token> --readable-amount 1 --chain <chain>
- Compare against entry price
- Calculate unrealized PnL
- Report with recommendation (hold / take profit / cut loss)
Output Templates
Signal Report Template
🔔 Smart Money Signal
📍 Source: {address_short} (Win Rate: {winRate}%, Realized PnL: ${pnl})
⛓️ Chain: {chain}
🎯 Token: {tokenSymbol} ({tokenContract_short})
💰 Buy Amount: ${amount} ({tokenAmount} {tokenSymbol})
🕐 Time: {timestamp}
📊 Signal Strength: {strength} ({reason})
🔒 Security Check:
• Honeypot: ✅ Pass / ❌ BLOCK
• Risk Level: {level} ✅ / ⚠️
• Liquidity: ${liquidity} ✅ / ⚠️
• Token Age: {age}
• Tax: Buy {buyTax}% / Sell {sellTax}%
💡 Recommendation: {action}
Would you like to follow this trade? How much do you want to allocate?
Portfolio Performance Template
📊 Follow Trade Performance
| # | Token | Entry | Current | PnL | Status |
|---|-------|-------|---------|-----|--------|
| 1 | {sym} | ${entry} | ${current} | {pnl}% | {emoji} |
| 2 | ... | ... | ... | ... | ... |
Total Unrealized PnL: ${totalPnl} ({totalPnlPct}%)
Win/Loss: {wins}W / {losses}L
Risk Controls
- NEVER auto-execute trades without explicit user confirmation
- NEVER recommend tokens with risk level ≥ 3 (also ineligible for competition PnL)
- NEVER follow a smart money address into a token with `isHoneyPot = true`
- NEVER allocate more than 50% of user's balance to a single follow trade
- NEVER suppress security warnings — always show them, let user decide
- MUST run security check (Step 3) on EVERY token before recommending
- MUST show the smart money address's historical stats alongside the signal
- MUST remind user that smart money can also lose money — past performance ≠ future results
- MUST check competition eligibility (risk level ≤ 2) when user is in a competition
- MUST display full token contract address (abbreviated) so user can verify independently
Signal Strength Classification
| Strength | Criteria | Action |
|---|
| 🔥 Strong | Address win rate ≥ 75%, accumulation pattern (3+ buys), token risk ≤ 1 | Highlight as top signal |
| 🟡 Medium | Address win rate ≥ 60%, single large buy, token risk ≤ 2 | Standard signal |
| ⚪ Weak | Address win rate 60-65%, small buy, or token has warnings | Show with caveats |
| 🔴 Blocked | Token failed security check | Do not recommend |
Error Handling
| Error | Response |
|---|
| No smart money found on chain | "No qualifying smart money addresses found on {chain} at the moment. Try again later or switch chains." |
| Token info unavailable | "Could not fetch token info for {ca}. This may indicate a very new or low-liquidity token — exercise extreme caution." |
| Swap execution fails | Follow okx-dex-swap error retry logic. If approval pending, wait for block confirmation then retry. |
| User not logged in | Route to okx-agentic-wallet login flow. |
| Region restriction | "Service is not available in your region." |
Examples
Example 1: User asks "What are whales buying on X Layer?"
Agent: Let me check the top profitable wallets on X Layer.
[Runs: onchainos dex-market address-tracker --chain xlayer --sort-type pnl --limit 20]
[Filters: winRate ≥ 60%, trades ≥ 10, active within 7d, PnL > $500]
Agent: Found 5 Tier 1 smart money addresses. Let me analyze their recent activity.
[Runs address-tracker for each top address]
Agent: Here are today's top signals:
🔔 Smart Money Signal
📍 Source: 0x1a2b...3c4d (Win Rate: 78%, Realized PnL: $12,450)
⛓️ Chain: X Layer
🎯 Token: PEPE (0x6982...a0e3)
💰 Buy Amount: $2,500 (180M PEPE)
🕐 Time: 2 hours ago
📊 Signal Strength: 🔥 Strong (accumulation — 3rd buy in 24h)
🔒 Security Check:
• Honeypot: ✅ Pass
• Risk Level: 2 ✅
• Liquidity: $1.2M ✅
• Token Age: 45 days
• Tax: Buy 1% / Sell 1%
💡 Recommendation: Strong signal. Address has 78% win rate across 45 trades.
Accumulation pattern suggests high conviction.
Would you like to follow this trade? How much USDT do you want to allocate?
Example 2: User says "帮我跟单这个地址 0xabcd...1234"
Agent: Let me analyze this address's recent activity and trading performance.
[Runs: onchainos dex-market address-tracker --chain xlayer --address 0xabcd...1234 --limit 20]
Agent: Address 0xabcd...1234 stats:
• Win Rate: 72% (32/45 trades profitable)
• Realized PnL: $8,200
• Last active: 30 minutes ago
• Recent buys: TOKEN_A ($1,200), TOKEN_B ($800)
Let me run security checks on their latest purchases...
[Runs dex-token advanced-info for each token]
Agent: TOKEN_A passed all checks. TOKEN_B has ⚠️ warning (token age < 24h).
Which trade would you like to follow, and how much do you want to allocate?
Competition Tips
When participating in the Agentic Trading Contest:
- Use X Layer — zero gas fees mean you can iterate faster
- Avoid stablecoin swaps — USDT-USDC, SOL-USDC don't count for PnL
- Only risk level ≤ 2 tokens — level 3+ profits are excluded from competition ranking
- Realized profit only — you must SELL to count the profit; holding doesn't help
- Minimum $1,000 volume — needed to qualify for PnL leaderboards
- Maintain $100+ balance — required for participation prize eligibility
