agentleFS
agiprolabsagiprolabs/claude-trading-skills/skills/copy-trading/SKILL.md

copy-trading

Skill366 starsChanged 8 months agoMITView on GitHub

Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 6 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Your own analysis: run token-holder-analysis on a token that performed well, then profile the top holders

    line 38
  2. Very specific:

    Every discovered wallet must pass quantitative evaluation before it enters a copy list.

    line 44
  3. Very specific:

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

    line 58
  4. Distinctive:

    After evaluation, apply additional filters:

    line 62
  5. Distinctive:

    Size compatibility: if they trade 500 SOL per position and you have 10 SOL total, proportional sizing may be too small to cover fees

    line 66
  6. Very specific:

    Sybil check: use the sybil-detection skill to verify the wallet is not part of a wash-trading cluster

    line 67
  7. Distinctive:

    When a monitored wallet executes a swap:

    line 83
  8. Distinctive:

    Use a constant SOL amount per copy trade (e.g., 0.5 SOL).

    line 146
  9. Distinctive:

    Never copy a trade without understanding what the token is.

    line 175
  10. Distinctive:

    If you copy 5 wallets and they all buy the same token, you have 5x the intended exposure.

    line 181

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

DimensionTradFi (eToro, etc.)Solana On-Chain
Data sourcePlatform-reported P&LVerifiable on-chain transactions
LatencyMinutes to hoursSeconds (websocket) to sub-second (gRPC)
Front-running riskLowHigh (MEV bots, sandwich attacks)
Trade costCommissions + spreadGas + slippage + priority fees
CapacityHigh (large-cap equities)Low (micro-cap tokens have thin liquidity)
Signal decaySlowFast (PumpFun tokens move in minutes)
TransparencyPartial (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:

MetricMinimumWhy
Trade count (30d)>= 50Statistical significance
Win rate>= 55%Edge above random
Profit factor>= 1.5Wins meaningfully exceed losses
Last activeWithin 7 daysStill trading, not abandoned
Distinct tokens traded>= 10Not 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:

ControlRecommended ValuePurpose
Max allocation per wallet10-20% of portfolioDiversification across signal sources
Max concurrent copy positions3-5Prevent overexposure
Per-trade stop loss-15% to -25%Independent downside protection
Daily copy-trade loss limit-5% of portfolioCircuit breaker
Weekly copy-trade loss limit-10% of portfolioLonger-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:

  • Trade count score: min(trade_count / 200, 1.0) * 100 — maxes out at 200 trades
  • Win rate score: max((win_rate - 0.40) / 0.30, 0) * 100 — scaled from 40% to 70%
  • Profit factor score: min((pf - 1.0) / 3.0, 1.0) * 100 — scaled from 1.0 to 4.0
  • Consistency score: (1.0 - std_dev_of_rolling_win_rate) * 100 — lower variance = higher score
  • Recency score: max(1.0 - days_since_last_trade / 14, 0) * 100 — decays over 14 days
  • Human probability score: (1.0 - bot_probability) * 100

Interpretation:

ScoreRatingAction
80-100ExcellentStrong copy-trade candidate
60-79GoodSuitable with monitoring
40-59MarginalProceed with caution, reduce allocation
0-39PoorDo not copy

Position Sizing for Copy Trades

Three approaches, from simplest to most nuanced:

Fixed Amount

Use a constant SOL amount per copy trade (e.g., 0.5 SOL). Simple but ignores the wallet's conviction level.

Proportional

Match the copied wallet's allocation as a percentage of their estimated portfolio:

your_size = (their_trade_size / their_estimated_portfolio) * your_portfolio

Requires estimating their total portfolio, which can be imprecise.

Confidence-Scaled

Base amount multiplied by your confidence in the wallet:

your_size = base_amount * (copy_score / 100) * conviction_multiplier

Where conviction_multiplier is higher for wallets with longer track records.

Anti-Patterns to Avoid

Copying Bots

Bots have sub-second execution and often use MEV strategies. You cannot match their latency. By the time you detect their trade, the opportunity is gone or you become the exit liquidity. Use the bot probability score to filter these out.

Survivorship Bias

A wallet with 1000% returns from one PumpFun token is not necessarily skilled. Look for wallets with consistent performance across many tokens, not outlier wins. The max-single-trade-PnL filter catches this.

Blind Following

Never copy a trade without understanding what the token is. At minimum, run basic safety checks: liquidity depth, holder concentration, contract verification. A 2-second check can prevent buying a honeypot.

No Independent Exits

The copied wallet may have information you do not have. They may exit for reasons unrelated to the trade. Always maintain your own stop loss. Never rely solely on mirroring their exit.

Correlation Risk

If you copy 5 wallets and they all buy the same token, you have 5x the intended exposure. Track aggregate position across all copy sources and enforce portfolio-level limits.

Ignoring Capacity

A wallet profiting on tokens with $50K daily volume cannot be copied at scale. If your trade is 10% of daily volume, you will move the price against yourself.

Integration with Other Skills

SkillHow It Integrates
wallet-profilingDeep behavioral analysis of candidate wallets
sybil-detectionVerify wallet is not part of a wash-trading ring
token-holder-analysisSafety check tokens before copying a buy
liquidity-analysisVerify sufficient liquidity to enter/exit
helius-apiWebSocket monitoring and transaction parsing
jupiter-api / jupiter-swapTrade execution via aggregator
slippage-modelingEstimate execution cost of the copy trade
position-sizingPortfolio-aware sizing for copy positions
risk-managementPortfolio-level risk controls

Files

References

  • references/wallet_discovery.md — Sources and methods for finding copy-trade candidates
  • references/execution_strategy.md — Monitoring infrastructure and execution approaches
  • references/risk_framework.md — Portfolio-level risk controls for copy trading

Scripts

  • scripts/evaluate_wallet.py — Comprehensive copy-trade suitability scoring for a wallet
  • scripts/monitor_wallet.py — Real-time wallet transaction monitoring with trade alerts

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.