🚀 Binance Copy Trading Scraper & Analytics Pro

The ONLY working Binance Copy Trading scraper with built-in analytics! Extract trader data, track whale positions, and generate AI-ready signals with Winners vs Losers divergence analysis.

While other scrapers use deprecated APIs that return 404 errors, this Actor uses browser-based automation with the official Copy Trading interface that actually works!

✨ Why Choose This Scraper?

Feature	Other Scrapers	This Actor
Copy Trading Leaderboard	❌ Not supported	✅ Full support
Futures Leaderboard (deprecated)	✅ (returns 404)	⚠️ Deprecated
Current Positions	✅ Basic	✅ Full details
Winners vs Losers Analysis	❌	✅ UNIQUE
Direction Bias Calculation	❌	✅ UNIQUE
Battle Score per Symbol	❌	✅ UNIQUE
TRUE LOSERS Mode	❌	✅ UNIQUE
Copy Trading Coefficients	❌	✅ UNIQUE
CSV/XLSX Export	❌	✅ INCLUDED

🎯 Three Operating Modes

Mode 1: Leaderboard Scraping

Scrape top traders from Binance Copy Trading leaderboard:

• ROI, PNL, Win Rate rankings
• Copier count and follower data
• Current open positions with leverage

Mode 2: Tracking Mode

Track specific traders by their Portfolio ID:

• Real-time position monitoring
• Performance snapshots
• Perfect for whale watching

Mode 3: Analytics Mode 🔥

The killer feature! Analyze Winners vs Losers divergence:

• Scrape top winners AND bottom losers separately
• Calculate Direction Bias per symbol
• Generate Battle Scores
• Output Copy Trading Coefficients
• AI-ready trading signals

📊 Understanding the Analytics

Direction Bias

Measures market sentiment based on winner/loser positioning:

• BULLISH: Winners are predominantly LONG (>60%)
• BEARISH: Winners are predominantly SHORT (<40%)
• NEUTRAL: Balanced positions

Battle Score

Per-symbol divergence analysis (-100 to +100):

• +50 to +100: STRONG_LONG signal
• +25 to +50: LONG signal
• -25 to +25: NEUTRAL
• -50 to -25: SHORT signal
• -100 to -50: STRONG_SHORT signal

Copy Trading Coefficients

Position sizing recommendations based on winner/loser divergence:

{
    "longCoefficient": 1.0,
    "shortCoefficient": 0.1,
    "recommendation": "FAVOR_LONGS"
}

💰 Pricing

This Actor uses Pay per Event pricing:

Event	Free	Business
Actor Start	$0.03	$0.02
Trader data (per trader)	$0.01	$0.008
Position data (per position)	$0.01	$0.008
Analytics report 🔥	$5.00	$3.00
Actor Completion	$0.03	$0.02

Example costs (Free plan):

• 100 traders without positions: ~$1.06
• 100 traders + 200 positions: ~$3.06
• Analytics mode (100 traders + 200 positions + report): ~$8.06

🔧 Input Parameters

Parameter	Type	Default	Description
mode	string	analytics	Operating mode: leaderboard, tracking, or analytics
maxTraders	number	100	Maximum traders to scrape (1-200) for leaderboard mode
period	string	MONTHLY	Performance period: DAILY, WEEKLY, MONTHLY, ALL
sortBy	string	PNL	Ranking: PNL, ROI, WIN_RATE, COPIER_COUNT
withPositions	boolean	true	Include current positions (required for analytics)
portfolioIds	array	[]	Portfolio IDs for tracking mode
trueLosersMode	boolean	true	Get actual losing traders from bottom of leaderboard
winnersCount	number	50	Number of top winners to analyze
losersCount	number	50	Number of bottom losers to analyze
outputFormat	string	json	Output format: json, csv, or xlsx
requestDelay	number	500	Delay between requests (ms)
debugMode	boolean	false	Enable verbose logging

📤 Output Format

Each run produces multiple dataset items for flexible data processing:

Trader Item

{
    "type": "trader",
    "scrapedAt": "2025-01-05T18:30:00.000Z",
    "portfolioId": "3958362104",
    "nickname": "TraderPro",
    "pnl": 452200.50,
    "roi": 156.78,
    "mdd": 12.5,
    "sharpe": 2.45,
    "winRate": 0.72,
    "copierCount": 1250,
    "group": "winners",
    "positionsCount": 5,
    "positions": [
        {
            "symbol": "BTCUSDT",
            "positionAmount": 0.5,
            "entryPrice": 94150.00,
            "markPrice": 95200.00,
            "unrealizedProfit": 525.00,
            "leverage": 10
        }
    ]
}

Analytics Item

{
    "type": "analytics",
    "scrapedAt": "2025-01-05T18:30:00.000Z",
    "mode": "analytics",
    "directionBias": {
        "marketSentiment": "BULLISH",
        "winnersLongPercent": 87.5,
        "losersLongPercent": 35.2,
        "directionDivergence": "SIGNIFICANT"
    },
    "coefficients": {
        "longCoefficient": 1.0,
        "shortCoefficient": 0.1,
        "recommendation": "FAVOR_LONGS"
    },
    "divergenceData": [
        {
            "symbol": "BTC",
            "battleScore": 65.3,
            "signal": "STRONG_LONG",
            "winnersCount": 38,
            "losersCount": 12
        }
    ]
}

🚀 Quick Start Examples

Example 1: Full Analytics (Recommended) 🔥

{
    "mode": "analytics",
    "winnersCount": 50,
    "losersCount": 50,
    "trueLosersMode": true,
    "withPositions": true
}

Example 2: Scrape Top 100 Traders by PNL

{
    "mode": "leaderboard",
    "maxTraders": 100,
    "period": "MONTHLY",
    "sortBy": "PNL",
    "withPositions": true
}

Example 3: Track Specific Whales

{
    "mode": "tracking",
    "portfolioIds": ["3958362104", "4012876543"],
    "withPositions": true
}

Example 4: Export to Excel

{
    "mode": "analytics",
    "winnersCount": 50,
    "losersCount": 50,
    "outputFormat": "xlsx"
}

⚡ API Integration

Use the Apify API to integrate this scraper into your trading bot:

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "mode": "analytics",
    "winnersCount": 50,
    "losersCount": 50,
    "trueLosersMode": True,
    "withPositions": True
}

run = client.actor("hlwhales/binance-copy-trading-scraper").call(run_input=run_input)

# Get all traders
traders = []
analytics = None

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    if item["type"] == "trader":
        traders.append(item)
    elif item["type"] == "analytics":
        analytics = item

print(f"Fetched {len(traders)} traders")
print(f"Market Sentiment: {analytics['directionBias']['marketSentiment']}")
print(f"Recommendation: {analytics['coefficients']['recommendation']}")

❓ FAQ

Q: Why do other Binance scrapers return 404 errors? A: They use the deprecated Futures Leaderboard API endpoints. This Actor uses browser automation with the current Copy Trading interface.

Q: What is TRUE LOSERS mode? A: It fetches traders from the BOTTOM of the leaderboard (actual negative PNL) instead of just the lowest-ranked winners. This creates real divergence signals.

Q: How often should I run analytics? A: For day trading: every 1-4 hours. For swing trading: once daily. For position trading: every few days.

Q: Can I export to CSV/Excel? A: Yes! Set outputFormat to csv or xlsx. CSV creates two files (traders.csv, analytics.csv), XLSX creates one file with multiple sheets.

Q: Why are positions required for analytics? A: Direction Bias and Battle Scores are calculated from actual position data. Without positions, analytics will show NEUTRAL values.

📊 Use Cases

• Algorithmic Trading: Feed signals directly into your trading bot
• Market Research: Understand what top traders are doing vs losing traders
• Risk Management: Adjust position sizes based on Copy Trading Coefficients
• Sentiment Analysis: Track market sentiment shifts over time
• Whale Watching: Monitor specific successful traders

📞 Support

Having issues or need custom features? Open an issue on the Actor page or contact through Apify.

---

🐋 About the Developer

This Actor is developed and maintained by WhaleHunt.io — a professional crypto market data intelligence platform. We specialize in building advanced analytics tools for traders, quant researchers, and algorithmic trading systems.

Our expertise includes:

• Crypto exchange data extraction and analytics
• Whale wallet tracking and on-chain analysis
• Trading signal generation and market sentiment tools
• Custom data solutions for hedge funds and trading desks

Visit whalehunt.io for more crypto analytics tools and professional data intelligence solutions.