🎯 Crypto Sentiment Tracker README

Crypto Sentiment Tracker Pro

Get BUY/SELL signals from Reddit, Twitter & TikTok sentiment. Real-time crypto analysis perfect for trading bots & AI agents.

Monitor social media sentiment across multiple platforms to predict crypto price movements before they happen. This Actor aggregates sentiment data from Reddit discussions, Twitter trends, and TikTok viral content to generate actionable trading signals.

Powered by GenVox Sentiment API with x402 payment protocol support.

🎯 Use Cases

• Automated trading bots - Integrate sentiment signals into your trading algorithms
• Market sentiment analysis - Track community mood shifts in real-time
• Research and backtesting - Historical sentiment data for strategy development
• Alert systems - Get notified when sentiment changes dramatically
• Portfolio management - Make informed decisions based on social consensus

🚀 Quick Start

Run the Actor with a crypto coin symbol:

$apify run

Push to Apify Console:

apify login
apify push

📊 Input Configuration

Analyze sentiment for any cryptocurrency:

{
  "coin": "BTC"  // Cryptocurrency symbol: BTC, ETH, SOL, DOGE, etc.
}

Supported Cryptocurrencies

• BTC - Bitcoin
• ETH - Ethereum
• SOL - Solana
• DOGE - Dogecoin
• ADA - Cardano
• MATIC - Polygon
• AVAX - Avalanche
• DOT - Polkadot
• LINK - Chainlink
• And 100+ more altcoins

Example Inputs

Analyze Bitcoin sentiment:

{
  "coin": "BTC"
}

Check Ethereum market mood:

{
  "coin": "ETH"
}

Track Solana social buzz:

{
  "coin": "SOL"
}

📁 Project Structure

.actor/
├── actor.json              # Actor configuration
├── OUTPUT_SCHEMA.json      # Output data structure
└── INPUT_SCHEMA.json       # Input validation

src/
└── main.js                 # Actor entry point

storage/
├── datasets/               # Sentiment analysis results
└── key_value_stores/       # Run metadata

🔄 How it Works

1. Fetch Social Data: Scrapes Reddit, Twitter, TikTok for coin mentions
2. Analyze Sentiment: AI-powered sentiment analysis on all mentions
3. Generate Signal: Calculates overall BUY/SELL/NEUTRAL signal
4. Provide Metrics: Returns sentiment score, mention count, trending sources
5. Save Dataset: Stores comprehensive sentiment breakdown

📦 Output Format

Each sentiment analysis includes:

{
  "coin": "BTC",
  "signal": "STRONG BUY",
  "sentiment_score": 8.2,
  "confidence": "high",
  "mentions": {
    "reddit": 1234,
    "twitter": 5678,
    "tiktok": 910
  },
  "sentiment_breakdown": {
    "positive": 72,
    "neutral": 18,
    "negative": 10
  },
  "trend": "bullish",
  "key_topics": [
    "ETF approval",
    "institutional adoption",
    "price breakout"
  ],
  "recommendation": "Strong bullish sentiment across all platforms. Consider buying on dips.",
  "timestamp": "2026-01-10T16:45:00.000Z",
  "sources": {
    "reddit_threads": ["r/Bitcoin", "r/CryptoCurrency"],
    "twitter_trending": true,
    "tiktok_viral": false
  }
}

Signal Types

Signal	Sentiment Score	Description
STRONG BUY	7.5 - 10.0	Extremely positive sentiment, high conviction
BUY	5.0 - 7.4	Positive sentiment, favorable outlook
NEUTRAL	3.0 - 4.9	Mixed sentiment, wait for clearer signal
SELL	1.0 - 2.9	Negative sentiment, caution advised
STRONG SELL	0.0 - 0.9	Very negative sentiment, high risk

💰 Pricing

• Actor Start: $0.01 per run
• Per Coin Analysis: $0.05 per cryptocurrency analyzed

Example costs:

• Analyze BTC = $0.01 + $0.05 = $0.06
• Analyze 5 coins = $0.01 + ($0.05 × 5) = $0.26
• Analyze 10 coins = $0.01 + ($0.05 × 10) = $0.51

🤖 AI Agent Integration

This Actor supports the x402 protocol for AI agents:

• Agents can discover this Actor on x402scan.com
• Pay automatically with USDC on Base/Solana networks
• No API keys or manual setup required
• Perfect for autonomous trading bots

🎓 Use Cases in Detail

1. Automated Trading Bot

// Fetch sentiment every hour
const sentiment = await apifyClient.actor('your-username/crypto-sentiment-tracker').call({
  coin: 'BTC'
});

if (sentiment.signal === 'STRONG BUY' && sentiment.confidence === 'high') {
  // Execute buy order
  await exchange.buy('BTC', amount);
}

2. Portfolio Rebalancing

Monitor sentiment for your entire portfolio. Increase allocation to coins with improving sentiment, decrease exposure to negative sentiment coins.

3. Alert System

Run Actor every 30 minutes via Apify Scheduler. Send webhook to Slack/Discord when sentiment changes from NEUTRAL to BUY/SELL.

4. Research & Backtesting

Collect historical sentiment data. Correlate sentiment signals with price movements to validate trading strategies.

5. Risk Management

Use sentiment as confirmation signal. Only enter trades when both technical analysis AND sentiment align.

🔧 Development

Pull Actor for Local Development

# Install Apify CLI
npm install -g apify-cli

# Pull this Actor
apify pull your-username/crypto-sentiment-tracker

# Run locally
apify run

Test Locally

# Run with custom input
apify run --input '{"coin":"ETH"}'

📚 What's Included

• Multi-Platform Analysis - Reddit, Twitter, TikTok sentiment
• AI-Powered NLP - Advanced natural language processing
• Real-Time Data - Up-to-date social media mentions
• Trading Signals - Clear BUY/SELL/NEUTRAL recommendations
• Confidence Metrics - Know how reliable each signal is
• Trend Detection - Identify emerging narratives
• x402 Support - Works with AI agents and autonomous bots

🌐 Data Sources

Reddit

• r/CryptoCurrency (4.5M members)
• r/Bitcoin (5.2M members)
• r/ethereum (1.8M members)
• Coin-specific subreddits

Twitter (X)

• Crypto influencer tweets
• Trending hashtags
• Whale alerts
• News accounts

TikTok

• Viral crypto content
• Influencer recommendations
• Trending sounds/challenges

📊 Sentiment Accuracy

Our sentiment model has been trained on 2M+ crypto social media posts with:

• 82% accuracy on price movement prediction (24h window)
• 75% accuracy on trend detection (7-day window)
• 90% accuracy on major sentiment shifts

Past performance does not guarantee future results

🔗 Resources

• GenVox Sentiment API
• x402 Protocol Documentation
• Apify Platform Documentation
• Actor Development Guide
• [Break the cubicle on X

🎯 Best Practices

1. Don't trade on sentiment alone - Use as confirmation signal with technical analysis
2. Monitor multiple timeframes - Run Actor every 30min, 1h, and 4h for different perspectives
3. Track sentiment changes - Rapid shifts often precede price movements
4. Consider volume - High mention count + positive sentiment = stronger signal
5. Check multiple coins - Sector rotation often shows in sentiment before price

⚠️ Disclaimer

This Actor provides sentiment analysis for informational and educational purposes only. It is NOT financial advice.

Important:

• Cryptocurrency trading involves substantial risk of loss
• Sentiment data does not guarantee price movements
• Past accuracy does not ensure future performance
• Always do your own research (DYOR)
• Only invest what you can afford to lose
• Verify signals with multiple sources

The developers are not responsible for trading losses. Use at your own risk.

🐛 Issues & Support

Found a bug or have a feature request?

• Open an issue on GitHub
• Contact via Apify support
• Join our Discord community

📄 License

This Actor is available under the Apache 2.0 License.

---

Built with ❤️ using Apify Platform

Trade smarter with social sentiment. 📊🚀