ForexFactory Leaderboard Trader Tracker & Trading Signals

Stop guessing. Trade with the crowd — or against it.

This actor analyzes real traders on ForexFactory's public leaderboard, studies their open positions across major currency pairs, and generates directional trading signals based on where the best (and worst) performers are positioned right now.

---

💡 What You Get

• Trading signals (LONG / SHORT / NEUTRAL) for major forex pairs and gold — updated every run
• Trader profiles with full performance stats: return, win rate, profit factor, Sharpe ratio
• Economic calendar with high/medium/low impact events and affected currency pairs
• Contrarian confirmation — when top performers go long AND poor performers go short, the signal is flagged as STRONG

---

🚀 How It Works

ForexFactory hosts thousands of traders who publicly share their live trades. This actor:

1. Scrapes the live trades feed to identify active traders
2. Visits each trader's profile to collect performance statistics and open positions
3. Classifies traders — top 25% (Winners) vs bottom 25% (Losers) by composite score
4. Aggregates positions per currency pair with weighted scoring
5. Generates actionable signals — if Winners are long and Losers are short → LONG signal
6. Fetches live prices for all pairs from ForexFactory's market data API
7. Optionally scrapes the economic calendar for upcoming market-moving events

The more traders analyzed, the more reliable the signal. We recommend 50–200 traders for production use.

---

🎯 Modes

Mode	What it does	Speed
signals	Full leaderboard analysis → trading signals	5–15 min
traders	Profile stats for specific usernames	1–3 min
calendar	Economic calendar with impact filter	~30 sec
full	Signals + calendar combined	6–16 min

---

⚙️ Input Examples

Generate signals for major pairs:

{
  "mode": "signals",
  "pairs": ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD"],
  "maxTraders": 100
}

Track specific traders:

{
  "mode": "traders",
  "trackUsernames": ["toptrader1", "forexking", "goldmaster"]
}

Economic calendar — today, high impact only:

{
  "mode": "calendar",
  "calendarDays": "today",
  "calendarImpact": ["high"]
}

Full analysis — signals + calendar:

{
  "mode": "full",
  "pairs": ["EURUSD", "GBPUSD", "XAUUSD"],
  "maxTraders": 50,
  "calendarDays": "today",
  "calendarImpact": ["high", "medium"]
}

---

📊 Output Example

Trading Signal:

{
  "type": "signal",
  "pair": "EURUSD",
  "signal": "LONG",
  "strength": "STRONG",
  "score": 64.54,
  "contrarian": true,
  "rationale": "LONG | top traders: 105L/57S | confirmed by poor performers",
  "price": 1.16744,
  "traderCount": 8,
  "timestamp": "2026-05-14T15:11:17Z"
}

Trader Profile:

{
  "type": "trader",
  "username": "hbanna",
  "allTimeReturn": 716.7,
  "weekReturn": 3.7,
  "profitFactor": 2.58,
  "sharpeRatio": 0.92,
  "winRate": 86.8,
  "openPairs": ["GBPUSD", "ETHUSD"]
}

Calendar Event:

{
  "type": "calendar",
  "date": "Thu May 14",
  "time": "1:30pm",
  "currency": "USD",
  "impact": "high",
  "event": "Core Retail Sales m/m",
  "forecast": "0.7%",
  "previous": "1.9%",
  "affectedPairs": ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD"]
}

---

📋 Output Fields

Signal fields

Field	Description
pair	Currency pair (EURUSD, XAUUSD, etc.)
signal	LONG / SHORT / NEUTRAL
strength	STRONG / MODERATE / WEAK / N/A
score	Weighted net position score
contrarian	True if losers confirm the signal
rationale	Human-readable signal explanation
price	Current live price
traderCount	Number of traders with positions in this pair

Trader fields

Field	Description
allTimeReturn	All-time account return (%)
weekReturn	This week's return (%)
profitFactor	Gross profit / gross loss ratio
sharpeRatio	Risk-adjusted return
winRate	Winning trades percentage
openPairs	Currently open currency pairs

---

💰 Pricing

This actor uses pay-per-event billing — you only pay for what you scrape.

Event	Price
Trader profile analyzed	$0.20
Calendar event	$0.05

Estimated run cost:

• Calendar only (today, high impact) → ~$0.25–0.50
• 3 specific traders → ~$0.60
• Signals with 30 traders → ~$6
• Signals with 100 traders → ~$20

💡 For regular trading use, run with 30–50 traders on a schedule. Best value, reliable signals.

---

🎯 Use Cases

• Algorithmic trading — feed signals into your trading bot via API
• Market research — understand retail positioning on major pairs
• Sentiment analysis — track how the crowd is positioned before major news
• Trader monitoring — follow specific ForexFactory users and their open trades
• News trading — combine calendar events with positioning data for high-probability setups

---

⏰ Scheduling Tips

Run this actor on a schedule for fresh signals:

• Signals — every 4–8 hours for intraday positioning updates
• Calendar — once per day (morning) to plan your trading session
• Full mode — before major news events (NFP, CPI, FOMC)

---

⚠️ Notes

• ForexFactory uses Cloudflare protection — residential proxies are required and are included in the cost
• Signals reflect current open positions, not price predictions — always use with your own analysis
• More traders analyzed = more reliable signal. Minimum recommended: 20 traders