Token Sentiment

Returns the detailed Reddit report for one crypto symbol.

Includes:

buzz_score: normalized Reddit activity score for the selected period
trend: 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)
sentiment_score, bullish_pct, bearish_pct: directional sentiment signals
mentions, unique_posts, subreddit_count, total_upvotes: attributed volume and engagement signals, including inherited thread-context mentions
daily_trend: daily Reddit activity and sentiment values
top_mentions: representative high-engagement Reddit posts or comments from the selected period

Returns 200 with found: false when the symbol is supported but this service has no qualifying data in the requested window. Returns 404 only when the symbol is unsupported.

symbolstring required

Crypto symbol (e.g., BTC, $ETH, SOL)

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

symbolstring required

Token symbol

namestring nullable

Token name

foundboolean required

Legacy v1 data-availability flag. true means this service has qualifying data for this asset/window. false means the asset is supported, but this service has no qualifying data for the requested window. Planned for removal in v2.

buzz_scorenumber nullable

Buzz score

mentionsinteger nullable

Attributed mentions in the selected period, including inherited thread-context mentions

sentiment_scorenumber nullable

Average sentiment

positive_countinteger nullable

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

negative_countinteger nullable

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

neutral_countinteger nullable

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

total_upvotesinteger nullable

Total upvotes from attributed mentions

unique_postsinteger nullable

Distinct post count

subreddit_countinteger nullable

Distinct subreddit count

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).

bullish_pctinteger nullable

Bullish mention percentage

bearish_pctinteger nullable

Bearish mention percentage

period_daysinteger nullable

Analysis period in days

Example response

{
  "symbol": "ETH",
  "name": "Ethereum",
  "found": true,
  "buzz_score": 72.4,
  "mentions": 318,
  "sentiment_score": 0.27,
  "total_upvotes": 10422,
  "unique_posts": 73,
  "subreddit_count": 9,
  "trend": "stable",
  "bullish_pct": 43,
  "bearish_pct": 19,
  "period_days": 7,
  "top_subreddits": [
    {
      "subreddit": "ethtrader",
      "mentions": 91,
      "count": 91
    },
    {
      "subreddit": "cryptocurrency",
      "mentions": 84,
      "count": 84
    }
  ],
  "daily_trend": [
    {
      "date": "2026-02-24",
      "mentions": 48,
      "sentiment_score": 0.22,
      "buzz_score": 56.4,
      "bullish_pct": 58,
      "bearish_pct": 21
    },
    {
      "date": "2026-02-23",
      "mentions": 42,
      "sentiment_score": 0.19,
      "buzz_score": 51.7,
      "bullish_pct": 52,
      "bearish_pct": 24
    }
  ],
  "top_mentions": [
    {
      "text_snippet": "ETH setup still looks strong into the next catalyst.",
      "sentiment_score": 0.74,
      "sentiment_label": "positive",
      "upvotes": 1200,
      "subreddit": "ethtrader",
      "created_utc": "2026-02-24T09:15:00Z"
    }
  ]
}

v1

Token Sentiment

Path parameters

Query parameters

Response

Example response