Triggers: "smart money", "聰明錢", "whale", "鯨魚", "大戶", "KOL", "follow", "跟單", "wallet tracking", "錢包追蹤", "who's buying", "邊個買緊"
Track onchain smart money (whales, funds, KOLs, MEV bots) activity. Detect position changes and evaluate whether to follow.
This skill enforces the MOST RESTRICTIVE safety rules of all skills.
Before executing any command, verify the following MCP servers are available.
| Server |
|---|
| Required |
|---|
| Purpose |
|---|
| OnchainOS CLI | Critical | Primary data source -- smart money signals, token data, wallet balances |
| GoPlus MCP | Critical | Token security check on EVERY tracked token; wallet address screening |
| DexScreener MCP | Optional | Additional market context, token pair data |
| Rug Munch MCP | Optional | Deployer history analysis, serial rugger detection |
| Nansen MCP | Optional | Premium wallet labels and entity classification |
Run the OnchainOS pre-flight check:
onchainos dex-market signal-chains
This returns the list of chains with signal support. If it fails, OnchainOS
is not properly configured -- see config/mcp-setup-guide.md.
| Command | Purpose | Read/Write |
|---|---|---|
scan | Discover recent smart money activity across chains | Read |
track-wallet | Monitor a specific wallet for position changes | Read |
evaluate | Deep analysis of whether a specific signal is worth following | Read |
leaderboard | Top performing wallets by realized PnL over a period | Read |
copy-plan | Generate a trade plan based on a signal -- REQUIRES HUMAN APPROVAL | Read |
All commands are read-only. No trades are executed.
Discover recent smart money activity.
smart-money-tracker scan --chains ethereum,solana,base --categories whale,fund --lookback-hours 24
| Parameter | Type | Required | Default | Enum | Validation |
|---|---|---|---|---|---|
--chains | string[] | No | ["ethereum","solana","base"] | All OnchainOS-supported chains | Supported by signal-chains |
--categories | string[] | No | all | whale, fund, kol, mev, dex_trader | Valid category name |
--lookback-hours | integer | No | 24 | 1 - 168 | Positive integer |
--min-amount-usd | number | No | 10000 | 0 - infinity | Positive number |
--action-filter | string | No | all | buy, sell, add_liquidity, remove_liquidity | Valid action |
--top-n | integer | No | 20 | 1 - 100 | Positive integer |
Return Schema:
SmartMoneySignal:
timestamp: integer # Unix ms
scan_params:
chains: string[]
categories: string[]
lookback_hours: integer
signals:
- wallet_address: string
wallet_type: string # "whale" | "fund" | "kol" | "mev" | "dex_trader"
wallet_label: string # Known label if available, else truncated address
chain: string
action: string # "buy" | "sell" | "add_liquidity" | "remove_liquidity"
token_address: string
token_symbol: string
amount_usd: number
tx_hash: string
signal_timestamp: integer # When the onchain action occurred (Unix ms)
signal_age_min: integer # (now - signal_timestamp) / 60000
signal_strength: string # "HIGH" | "MEDIUM" | "LOW" | "STALE"
strength_score: number # 0.0 - 1.0
security_check: # GoPlus result summary
is_honeypot: boolean
buy_tax_pct: number
sell_tax_pct: number
is_open_source: boolean
holder_concentration_pct: number
overall: string # "SAFE" | "WARN" | "BLOCK"
is_actionable: boolean # true only if: strength != STALE AND security == SAFE
Monitor a specific wallet address for position changes.
smart-money-tracker track-wallet --address 0x1234...5678 --chain ethereum --lookback-hours 72
| Parameter | Type | Required | Default | Enum | Validation |
|---|---|---|---|---|---|
--address | string | Yes | -- | Wallet address | Valid address format |
--chain | string | No | auto-detect | Supported chain | OnchainOS-supported |
--lookback-hours | integer | No | 72 | 1 - 720 | Positive integer |
Pre-checks before tracking:
check_address_security -- BLOCK if malicious, phishing, or blacklisted.wallet-portfolio all-balances -- retrieve current holdings.Return Schema:
WalletTrackResult:
wallet_address: string
wallet_label: string
address_security: object # GoPlus check_address_security result
chain: string
current_holdings:
- token_symbol: string
token_address: string
balance_usd: number
pct_of_portfolio: number
recent_activity:
- action: string
token_symbol: string
amount_usd: number
timestamp: integer
tx_hash: string
signal_age_min: integer
stats:
total_portfolio_usd: number
num_tokens: integer
largest_position_pct: number
activity_count_7d: integer
Deep analysis of whether a specific signal is worth following.
smart-money-tracker evaluate --signal-token 0xabcd...ef01 --signal-wallet 0x1234...5678 --chain ethereum
| Parameter | Type | Required | Default | Enum | Validation |
|---|---|---|---|---|---|
--signal-token | string | Yes | -- | Token address | Valid address |
--signal-wallet | string | Yes | -- | Wallet address | Valid address |
--chain | string | Yes | -- | Chain name | OnchainOS-supported |
--size-usd | number | No | 500 | 1 - 5,000 | Below max_copy_size |