v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Reddit Crypto

Trending tokens

Returns the crypto assets with the strongest Reddit discussion activity in the selected period, ranked by buzz_score.

Includes:

buzz_score: normalized 0-100 activity score used for ranking
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
trend_history: independent UTC-day buzz scores, oldest to newest; minimum 7 values; the live final value describes today so far and can differ from the selected-period buzz_score; missing days are 0.0

get/reddit/crypto/v1/trending

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.

limitinteger

Maximum tokens to return

offsetinteger

Pagination offset

Response

Successful Response

symbolstring required

Token symbol

namestring nullable

Token name

buzz_scorenumber required

Buzz score (0-100)

trend'rising' | 'falling' | 'stable' required

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

Attributed mention count, including inherited thread-context mentions

unique_postsinteger required

Unique Reddit post count

subreddit_countinteger required

Unique subreddit count

sentiment_scorenumber required

Average sentiment score

bullish_pctinteger required

Bullish mention percentage

bearish_pctinteger required

Bearish mention percentage

total_upvotesinteger required

Total upvotes from attributed mentions

trend_historynumber[]

Daily buzz scores (oldest to newest). Length follows the resolved period, with a minimum of 7 values.

Example response

[
  {
    "symbol": "BTC",
    "name": "Bitcoin",
    "buzz_score": 78.1,
    "trend": "rising",
    "mentions": 423,
    "unique_posts": 97,
    "subreddit_count": 12,
    "sentiment_score": 0.31,
    "bullish_pct": 47,
    "bearish_pct": 18,
    "total_upvotes": 15620,
    "trend_history": [
      42.3,
      46.8,
      51.2,
      58.9,
      64,
      71.4,
      78.1
    ]
  }
]