v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB
Reddit Crypto

Compare tokens

Compare up to 10 crypto symbols side by side over the same UTC calendar-day period.

Use it when you already know the symbols and want a compact ranked table instead of full detail reports. Results are sorted by buzz_score descending and include attributed mentions, trend, trend_history, unique_posts, subreddit_count, sentiment_score, bullish_pct, bearish_pct and total_upvotes. 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).

get/reddit/crypto/v1/compare

Query parameters

fromstring date nullable

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

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.

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.

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

symbolsstring required

Comma-separated symbols (e.g., BTC,ETH,SOL)

Comma-separated symbols (e.g., BTC,ETH,SOL)

Response

Successful Response

period_daysinteger required

Analysis period in days

Example response

{
  "period_days": 7,
  "tokens": [
    {
      "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
      ]
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "buzz_score": 72.4,
      "trend": "stable",
      "mentions": 318,
      "unique_posts": 73,
      "subreddit_count": 9,
      "sentiment_score": 0.27,
      "bullish_pct": 43,
      "bearish_pct": 19,
      "total_upvotes": 10422,
      "trend_history": [
        36.2,
        41.4,
        46.7,
        53.1,
        60.2,
        66.5,
        72.4
      ]
    }
  ]
}