Crypto Sentiment Analyzer

AI-powered cryptocurrency sentiment analysis combining Fear & Greed Index with news headline sentiment scoring.

Overview

This Actor analyzes cryptocurrency sentiment by:

1. Fetching the Fear & Greed Index from Alternative.me
2. Parsing recent cryptocurrency news from RSS feeds (CoinDesk, CoinTelegraph)
3. Filtering headlines related to the target cryptocurrency
4. Analyzing headline sentiment using local AI (Qwen3.5) with graceful fallback to keyword-based analysis
5. Computing overall sentiment score and classification

Inputs

Parameter	Type	Description	Example
coinId	string	Lowercase cryptocurrency identifier	"bitcoin"
coinName	string	Full cryptocurrency name for news filtering	"Bitcoin"

Outputs

{
  "coinId": "bitcoin",
  "coinName": "Bitcoin",
  "fearGreedIndex": {
    "value": 65,
    "classification": "Greed"
  },
  "overallSentiment": 0.35,
  "sentimentLabel": "positive",
  "newsAnalyzed": 8,
  "headlines": [
    {
      "headlineText": "Bitcoin Surges on Positive Market Sentiment",
      "source": "CoinDesk",
      "sentimentScore": 0.72,
      "sentimentLabel": "very_positive"
    }
  ],
  "processingTimeMs": 4250,
  "disclaimer": "..."
}

Sentiment Labels

• very_negative: score ≤ -0.75
• negative: -0.75 < score ≤ -0.25
• neutral: -0.25 < score < 0.25
• positive: 0.25 ≤ score < 0.75
• very_positive: score ≥ 0.75

Data Sources

• Fear & Greed Index: Alternative.me
• News Feeds: CoinDesk RSS, CoinTelegraph RSS
• Sentiment Analysis: Local AI server (Qwen3.5, Apache 2.0 License)

Pricing

$0.05 per analysis (sentiment-analyzed event)

Apify's revenue share: 20% platform fee, 80% to developers.

Disclaimer

This Actor provides AI-powered sentiment analysis for INFORMATIONAL AND EDUCATIONAL PURPOSES ONLY.

Sentiment Analysis Disclosure

• Sentiment scores reflect analysis of publicly available news headlines, NOT market predictions
• Positive sentiment does NOT guarantee price increases
• Negative sentiment does NOT guarantee price decreases
• AI-generated sentiment scores have inherent limitations and may be inaccurate
• Headlines analyzed may not represent the complete market narrative
• Analysis is based on English-language news only

This is NOT

• Financial advice or investment advice
• Trading recommendations or buy/sell signals
• A guarantee of data accuracy
• An endorsement of any investment strategy

Risk Disclosure

• Cryptocurrency is highly volatile and involves substantial risk of total loss
• Past performance is NOT indicative of future results
• Always conduct your own research (DYOR)
• Consult a licensed financial advisor before making investment decisions

Data Attribution

• Fear & Greed Index by Alternative.me
• News Headlines from public RSS feeds (CoinDesk, CoinTelegraph)
• Sentiment Analysis powered by Qwen3.5 (local AI, Apache 2.0 License)

Limitation of Liability

The creators assume no responsibility for:

• Financial losses or gains
• Investment decisions made based on this data
• Accuracy of sentiment scores
• API availability or data completeness

By using this Actor, you acknowledge that you have read and agreed to this disclaimer.

Error Handling

• Fear & Greed Index failures: Attempts to fetch, marks as "unavailable" on error but continues
• RSS feed failures: Silently continues to next feed source
• AI sentiment analysis failures: Falls back to keyword-based sentiment analysis
• Network timeout: 30 seconds for API calls, 15 seconds for AI analysis
• Graceful degradation: Actor always completes with whatever data is available

Sentiment Analysis Methods

Primary: AI-Powered (Qwen3.5)

• Requires connectivity to https://ai.ntriq.co.kr
• Returns confidence scores and detailed sentiment classification
• Timeout: 15 seconds per headline

Fallback: Keyword-Based

• Analyzes headlines for positive/negative keywords
• Works offline, no AI dependency
• Automatic activation if AI server unavailable or timeout
• Keywords include: surge, gains, profit, crash, plunge, loss, etc.

Example Usage

# Run locally
npm install
npm start

# Deploy to Apify
apify push

# Call via API
curl -X POST https://api.apify.com/v2/acts/your-user~crypto-sentiment-analyzer/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "coinId": "ethereum",
    "coinName": "Ethereum"
  }'

Technical Stack

• Runtime: Node.js 18.0+
• Core: Apify SDK 3.5.2
• AI Server: https://ai.ntriq.co.kr/sentiment
• RSS Parsing: Native JavaScript (no external libraries)

Performance

• Typical execution time: 30-60 seconds
• Average cost: $0.05 per analysis
• Rate limiting: Respects alternative.me and news feed rate limits

Support

For issues or feature requests, contact: support@ntriq.co.kr