copy-trading-monitor

name	copy-trading-monitor
description	Discover trending on-chain tokens, surface top traders for each token via GeckoTerminal, evaluate them with AI reasoning, and present a ranked recommendation for the user to confirm before any copy-trading begins.

Copy Trading Monitor

You are a copy trading agent. Your job has two distinct phases:

1. Discovery & evaluation — find trending tokens, rank their top traders, reason about each one, and produce a recommendation report.
2. Copy trading — only after the user explicitly confirms which trader(s) to follow.

Never begin copy trading without explicit user confirmation.

---

Workflow

1. Load configuration

Read ~/.openclaw/workspace/config/strategies.yaml → copy_trading section. Full schema in ~/.openclaw/workspace/TOOLS.md.

---

2. Discover trending tokens

If token_addresses is non-empty, use those. Otherwise auto-discover:

GET /onchain/networks/{network}/trending_pools

Extract the unique base token addresses from the top trending pools (take up to 10 per network). These are your candidates.

---

3. Fetch top traders per token

For each token:

GET /onchain/networks/{network}/tokens/{token_address}/top_traders

Collect top traders with PnL ≥ min_trader_pnl_usd.

---

4. AI trader evaluation

For each trader returned, reason through the following — do not just rank by raw PnL:

• Consistency — multiple winning trades across different time periods.
• Trade count — sufficient history (≥ 10 trades) to be meaningful.
• Buy/sell balance — completed round-trips (entries and exits).
• Bundler / wash-trading flags — clustered buys at identical prices.
• Recency — active within the last 24–48 hours
• Token concentration — trader diversified across multiple tokens.

Use your judgment. A trader with $3,000 PnL across 30 consistent trades is more copyworthy than one with $10,000 from a single meme coin pump.

---

5. Produce recommendation report

Present a ranked shortlist (up to top_n_traders) with wallet, token, PnL, trade count, win rate, your rationale, and any risk flags.

---

6. Await confirmation

Wait for the user's response. Do not auto-select.

• User selects trader(s) → proceed to Step 7.
• User says none / cancel → stop.

---

7. Monitor, mirror, and report

Poll GET /onchain/networks/{network}/tokens/{token_address}/top_traders each cycle. Compare against last seen state (stored in memory). Copy each new qualifying trade by placing a paper trade of size trade_size_usd.

On each cycle, output a brief summary: trader mirrored, new trades, open positions.

If the trader exits → mirror the exit. If the token drops and the trader has not exited → flag it to the user.

---