copy-trading

Files (6)

• SKILL.md
• execution_strategy.md · references/
• risk_framework.md · references/
• wallet_discovery.md · references/
• evaluate_wallet.py · scripts/
• monitor_wallet.py · scripts/

SKILL.md (first lines)

# Copy Trading

Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading. Identify profitable wallets on-chain, evaluate whether their edge is real and replicable, monitor their activity in real time, and execute proportionally-sized trades with independent risk controls.

## What Copy Trading Means on Solana

Copy trading is the practice of monitoring one or more wallets that have demonstrated consistent profitability and replicating their trades in your own wallet. On Solana, every DEX swap is publicly visible on-chain within seconds, making it technically feasible to detect and follow any wallet's activity.

### How It Differs from TradFi Copy Trading

| Dimension | TradFi (eToro, etc.) | Solana On-Chain |
|-----------|---------------------|-----------------|
| Data source | Platform-reported P&L | Verifiable on-chain transactions |
| Latency | Minutes to hours | Seconds (websocket) to sub-second (gRPC) |
| Front-running risk | Low | High (MEV bots, sandwich attacks) |
| Trade cost | Commissions + spread | Gas + slippage + priority fees |
| Capacity | High (large-cap equities) | Low (micro-cap tokens have thin liquidity) |
| Signal decay | Slow | Fast (PumpFun tokens move in minutes) |
| Transparency | Partial (delayed reporting) | Full (every transaction is public) |

The core tradeoff: Solana provides perfect transparency but introduces execution risk. The wallet you copy got a price that no longer exists by the time you trade.

## The Copy-Trade Pipeline

### Stage 1 — Discovery

Find wallets with strong track records. Sources include:

- **SolanaTracker Top Traders**: `GET /top-traders/{token}` returns the highest-PnL wallets for any token
- **Birdeye Trader Rankings**: wallet-level P&L leaderboards by token or globally
- **On-chain leaderboards**: community-built dashboards (GMGN, Cielo, Arkham)
- **Social signals**: wallets shared on Twitter/X or Telegram alpha groups
- **Your own analysis**: run `token-holder-analysis` on a token that performed well, then profile the top holders

See `references/wallet_discovery.md` for detailed source documentation and scoring methodology.

### Stage 2 — Evaluation

Every discovered wallet must pass quantitative evaluation before it enters a copy list. Use the `wallet-profiling` skill for deep behavioral analysis, then apply copy-trade-specific criteria.

**Minimum thresholds:**

| Metric | Minimum | Why |
|--------|---------|-----|
| Trade count (30d) | >= 50 | Statistical significance |
| Win rate | >= 55% | Edge above random |
| Profit factor | >= 1.5 | Wins meaningfully exceed losses |
| Last active | Within 7 days | Still trading, not abandoned |
| Distinct tokens traded | >= 10 | Not a one-token wonder |
| Max single-trade % of total PnL | < 40% | Not reliant on one lucky hit |
| Bot probability | < 30% | Human-like timing patterns |

Run `scripts/evaluate_wallet.py` for a comprehensive copy-trade suitability assessment.

### Stage 3 — Filtering

After evaluation, apply additional filters:

- **Consistency check**: rolling 7-day win rate should not swing below 40% in any period
- **Style compatibility**: understand whether the wallet is a sniper, scalper, or swing trader — your infrastructure must match their speed
- **Size compatibility**: if they trade 500 SOL per position and you have 10 SOL total, proportional sizing may be too small to cover fees
- **Sybil check**: use the `sybil-detection` skill to verify the wallet is not part of a wash-trading cluster

### Stage 4 — Monitoring

Once a wallet passes evaluation and filtering, set up real-time monitoring.

**Monitoring approaches (fastest to simplest):**

1. **Yellowstone gRPC**: sub-second latency, streams all transactions for subscribed wallets
2. **Helius Enhanced WebSocket**: near-real-time with parsed transaction data
3. **Polling via RPC**: `getSignaturesForAddress` every 5-10 seconds — simple but slower

See `references/execution_strategy.md` for implementation details on each approach.

### Stage 5 — Execution

When a monitored wallet executes a swap:

1. **Detect** the transaction (via monitoring infrastructure)
2. **Parse** the trade: token address, direction (buy/sell), size
3. **Validate** the token: check liquidity, holder distribution, honeypot risk
4. **Size** the position: proportional to your portfolio, not theirs
5. **Execute** via Jupiter aggregator with appropriate slippage tolerance
6. **Record** the copy trade with attribution to the source wallet

### Stage 6 — Risk Management

Copy trades require independent risk controls that do not depend on the copied wallet's behavior.

See `references/risk_framework.md` for the complete framework.

**Key limits:**

| Control | Recommended Value | Purpose |
|---------|------------------|---------|
| Max allocation per wallet | 10-20% of portfolio | Diversification across signal sources |
| Max concurrent copy positions | 3-5 | Prevent overexposure |
| Per-trade stop loss | -15% to -25% | Independent downside protection |
| Daily copy-trade loss limit | -5% of portfolio | Circuit breaker |
| Weekly copy-trade loss limit | -10% of portfolio | Longer-term circuit breaker |

## Wallet Scoring for Copy Suitability

Composite score from 0-100 based on weighted criteria:

```
copy_score = (
    trade_count_score * 0.15 +
    win_rate_score * 0.20 +
    profit_factor_score * 0.25 +
    consistency_score * 0.20 +
    recency_score * 0.10 +
    human_probability_score * 0.10
)
```

**Component calculations:**

From Serennity007/awesome-stock-quant-skills, MIT.

More from Serennity007/awesome-stock-quant-skills