v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Reddit Crypto

Market Sentiment

Returns the service-level Reddit Crypto market sentiment snapshot across all tracked assets when you want a single Reddit-Crypto-wide market state instead of per-asset rankings. It includes service-wide buzz, sentiment split, activity trend, breadth metrics and the top drivers by current buzz_score.

buzz_score here means relative Reddit Crypto market heat, not pure bullishness. It measures how hot overall Reddit crypto discussion is versus Reddit Crypto's own trailing 90-day baseline:

around 50 = normal Reddit crypto activity
higher = more active than usual
lower = quieter than usual

trend is activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, upvotes and subreddit breadth; not price movement. For from/to, anchors at to (or now when to is today).

Use sentiment_score, bullish_pct and bearish_pct for direction.

mentions includes inherited thread-context mentions. Use raw /mentions without include_inherited for explicit-only rows.

get/reddit/crypto/v1/market-sentiment

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Response

Successful Response

buzz_scorenumber nullable required

Service-wide Reddit Crypto heat score relative to the trailing 90-day baseline for the selected period

trend'rising' | 'falling' | 'stable' nullable

Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, upvotes and subreddit breadth; not price movement. For from/to, anchors at to (or now when to is today).

mentionsinteger required

Total Reddit mentions across the selected period, including inherited thread-context mentions

unique_postsinteger required

Exact distinct Reddit post count across the selected UTC period

subreddit_countinteger required

Distinct subreddits contributing in the selected period

total_upvotesinteger required

Total upvotes across attributed mentions in the selected period

active_tickersinteger required

Number of crypto symbols with activity in the selected period

sentiment_scorenumber nullable

Service-wide average sentiment score across the selected period

positive_countinteger required

Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility.

negative_countinteger required

Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility.

neutral_countinteger required

Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility.

bullish_pctinteger required

Bullish mention percentage

bearish_pctinteger required

Bearish mention percentage

trend_historynumber[]

Daily service-wide Reddit Crypto heat scores (oldest→newest), each calibrated relative to the trailing 90-day baseline. Length = max(requested_days, 7) for successful requests; windows before platform availability return HTTP 422.

Example response

{
  "buzz_score": 52.4,
  "trend": "stable",
  "mentions": 5412,
  "unique_posts": 1184,
  "subreddit_count": 37,
  "total_upvotes": 41290,
  "active_tickers": 89,
  "sentiment_score": 0.117,
  "positive_count": 2101,
  "negative_count": 1318,
  "neutral_count": 1993,
  "bullish_pct": 39,
  "bearish_pct": 24,
  "trend_history": [
    47.1,
    49.3,
    50.4,
    52.2,
    51.8,
    53,
    52.4
  ],
  "drivers": [
    {
      "symbol": "BTC",
      "mentions": 423,
      "buzz_score": 78.1,
      "sentiment_score": 0.31
    },
    {
      "symbol": "ETH",
      "mentions": 318,
      "buzz_score": 72.4,
      "sentiment_score": 0.27
    }
  ]
}