---
title: "Compare tokens"
method: GET
path: "/reddit/crypto/v1/compare"
tags: ["Reddit Crypto"]
---

# Compare tokens

`GET /reddit/crypto/v1/compare`

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

## Query parameters

- `from` string, date, nullable — Start date in YYYY-MM-DD. Inclusive UTC date.
- `to` string, date, nullable — End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.
- `days` integer — Deprecated v1 compatibility shorthand. Prefer `from` and `to` for reproducible UTC date windows.
- `symbols` string, required — Comma-separated symbols (e.g., BTC,ETH,SOL)

## Response `200`

Successful Response

- CryptoCompareResponse — Comparison response for multiple crypto symbols.
  - `period_days` integer, required — Analysis period in days
  - `tokens` CryptoCompareTokenItem[], required — Requested tokens sorted by buzz_score descending
    - `symbol` string, required
    - `name` string, nullable
    - `buzz_score` number, nullable, required
    - `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). Null when no qualifying data exists.
    - `mentions` integer, required — Attributed mentions in the selected period, including inherited thread-context mentions
    - `unique_posts` integer, required — Unique Reddit post count
    - `subreddit_count` integer, required — Unique subreddit count
    - `sentiment_score` number, nullable
    - `bullish_pct` integer, nullable
    - `bearish_pct` integer, nullable
    - `total_upvotes` integer, required — Total upvotes from attributed mentions
    - `trend_history` number[] — Daily buzz scores (oldest to newest). Length follows the resolved period, with a minimum of 7 values when data exists. Empty when no qualifying data exists.

## Other responses

- `400` — Invalid compare item list
- `401` — Authentication failed
- `403` — Historical data limit exceeded
- `422` — Invalid period or query parameters
- `429` — Rate limit exceeded
- `503` — Database temporarily unavailable
- `504` — Analytics request deadline exceeded

---

[API](https://skmtc.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/versions/351caf64ba81/schema)