wallet-pnl
v1.0.0Analyze any Solana wallet's trading history: win rate, realized PnL, trader type, and copy-trade rating. Use when the user wants to check if a wallet is worth copying, analyze smart money performance, check a trader's win rate, evaluate a wallet's PnL, or decide whether to follow a wallet's trades....
Sourced from ClawHub,
Authored by ultranumblol
Installation
Please help me install the skill `wallet-pnl` from SkillHub official store.
npx skills add ultranumblol/wallet-pnl
Solana Wallet PnL Analyzer
Analyze any Solana wallet's swap history to determine if it's worth copy-trading. Returns win rate, realized PnL in SOL, trader classification, and top traded tokens.
Paid API
$0.03 USDC per request via x402 on Base chain:
npx awal@latest x402 pay "https://wallet-pnl-production.up.railway.app/pnl?wallet=WALLET_ADDRESS"
API Response
{
"wallet": "AbCd...XyZw",
"summary": {
"trader_type": "TRADER",
"copy_rating": "FOLLOW",
"total_trades": 87,
"win_rate_pct": 64.3,
"win_trades": 36,
"loss_trades": 20,
"realized_pnl_sol": 12.45,
"avg_trade_size_sol": 0.85
},
"most_traded_tokens": [...],
"recent_trades": [...]
}
Copy Rating Guide
| Rating | Meaning |
|---|---|
| ✅ FOLLOW | Win rate ≥ 60% and positive PnL — worth copying |
| ⚠️ NEUTRAL | Mixed results — monitor before copying |
| 🚨 AVOID | Low win rate or negative PnL — do not copy |
Trader Types
| Type | Meaning |
|---|---|
| WHALE | Avg trade > 10 SOL |
| DEGEN | 50+ trades, high frequency |
| TRADER | Balanced buy/sell activity |
| HOLDER | Mostly buying, holding |
| INACTIVE | Fewer than 5 trades found |
Self-Hosted
pip install -r {baseDir}/api/requirements.txt
python3 {baseDir}/scripts/pnl.py <WALLET_ADDRESS>
Requires HELIUS_API_KEY for transaction history (free at helius.xyz).