Reddit Crypto Sentiment Tracker

Monitor the pulse of the crypto community in real time. This Actor scrapes Reddit's top crypto subreddits — r/CryptoCurrency, r/Bitcoin, r/ethereum, r/defi, r/CryptoMarkets, r/altcoin — and delivers structured sentiment data, trending token mentions, and discussion signals you can plug directly into trading systems, dashboards, or research pipelines.

---

What It Does

For each subreddit, the Actor fetches up to 100 hot posts via Reddit's public JSON API, then enriches every post with:

• Sentiment classification — keyword-based scoring across bullish and bearish signals
• Engagement tier — viral / high / moderate / low / minimal based on upvotes
• Token extraction — 30+ crypto tickers scanned per title (BTC, ETH, SOL, PEPE, …)
• Post type detection — news, discussion, meme, technical_analysis, question
• Controversy score — comments-to-score ratio (high = heated debate)
• Traction velocity — trending / rising / normal based on score × post age

A per-run aggregate summary (overall sentiment, top tokens, top posts, per-subreddit stats) is saved to a Key-Value Store for quick dashboard integration.

---

Use Cases

Use Case	How
Trading signals	Filter sentiment_label=very_bullish + traction_velocity=trending for momentum plays
Community monitoring	Track daily sentiment drift across multiple subreddits
Token discovery	mentioned_tokens reveals which coins are gaining mindshare before price moves
Meme coin radar	Filter post_type=meme + engagement_tier=viral in r/CryptoCurrency
Research & analytics	Feed structured JSON into LLMs or BI tools for deeper analysis

---

Input

Field	Type	Default	Description
subreddits	array	["CryptoCurrency","Bitcoin","ethereum","defi"]	Subreddit names to scrape
maxPostsPerSubreddit	integer	50	Posts per subreddit (10–100)
timeFilter	string	"day"	Reference period: hour / day / week / month

Example Input

{
  "subreddits": ["CryptoCurrency", "Bitcoin", "ethereum", "defi", "CryptoMarkets", "altcoin"],
  "maxPostsPerSubreddit": 100,
  "timeFilter": "day"
}

---

Output

Each post is pushed to the default dataset as one JSON record.

Fields

Field	Type	Description
subreddit	string	Source subreddit
post_id	string	Reddit post ID
title	string	Post title
score	integer	Net upvotes
upvote_ratio	float	Ratio 0–1
num_comments	integer	Comment count
created_utc	string	ISO8601 timestamp
url	string	Full post URL
flair	string|null	Post flair if set
author	string	Username
sentiment_label	string	very_bullish / bullish / neutral / bearish / very_bearish
sentiment_score	float	-1.0 (very bearish) to +1.0 (very bullish)
engagement_tier	string	viral / high / moderate / low / minimal
mentioned_tokens	array	Crypto tickers found in title
post_type	string	news / discussion / meme / technical_analysis / question
controversy_score	float	comments ÷ score — higher = more debate
traction_velocity	string	trending / rising / normal

Example Record

{
  "subreddit": "CryptoCurrency",
  "post_id": "1abc123",
  "title": "BTC breaks ATH — biggest bull rally since 2021",
  "score": 4821,
  "upvote_ratio": 0.94,
  "num_comments": 612,
  "created_utc": "2026-09-01T08:42:00Z",
  "url": "https://www.reddit.com/r/CryptoCurrency/comments/1abc123/",
  "flair": "News",
  "author": "crypto_whale99",
  "sentiment_label": "very_bullish",
  "sentiment_score": 0.8,
  "engagement_tier": "viral",
  "mentioned_tokens": ["BTC"],
  "post_type": "news",
  "controversy_score": 0.127,
  "traction_velocity": "trending"
}

Sentiment Summary (Key-Value Store)

The Key-Value Store reddit-crypto-sentiment-summary contains key SENTIMENT_SUMMARY with an aggregate object:

{
  "generated_at": "2026-09-01T09:00:00Z",
  "total_posts_analyzed": 300,
  "overall_sentiment": "bullish",
  "sentiment_distribution": {
    "very_bullish": 42,
    "bullish": 89,
    "neutral": 121,
    "bearish": 38,
    "very_bearish": 10
  },
  "top_tokens_mentioned": [
    {"token": "BTC", "mention_count": 88},
    {"token": "ETH", "mention_count": 54}
  ],
  "top_posts": [...],
  "subreddit_stats": {
    "CryptoCurrency": {
      "post_count": 100,
      "avg_score": 341.2,
      "sentiment_distribution": {"bullish": 35, "neutral": 48, ...}
    }
  }
}

---

Pricing

Pay-Per-Event: $0.001 per post analyzed

Run Size	Posts	Cost
Quick snapshot	50 posts × 4 subreddits	$0.20
Standard	100 posts × 6 subreddits	$0.60
Full portfolio	100 posts × 6 subreddits × 24 runs/day	~$14.40/day

No API keys required. Uses Reddit's public JSON API only.

---

How It Works

1. Fetches /r/{subreddit}/hot.json with limit=100 via the public Reddit API
2. Applies keyword scanning against 30+ bullish and 30+ bearish terms
3. Scans titles for 30+ crypto ticker symbols (BTC, ETH, SOL, PEPE, …)
4. Classifies post type based on flair and title patterns
5. Computes controversy and traction metrics
6. Charges $0.001 per processed post via Apify PPE
7. Pushes all records to dataset + summary to Key-Value Store

---

Notes

• Subreddits are scraped concurrently with a 1-second polite delay between each
• Posts are fetched from the hot listing; timeFilter is provided as metadata context (Reddit's hot endpoint doesn't filter by time)
• No Reddit account or API key needed — uses the public unauthenticated JSON API
• Rate-limit friendly: single User-Agent header, no parallel blasting