---
title: "Market Sentiment"
method: GET
path: "/reddit/crypto/v1/market-sentiment"
tags: ["Reddit Crypto"]
---

# Market Sentiment

`GET /reddit/crypto/v1/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.

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

## Response `200`

Successful Response

- CryptoMarketSentimentResponse — Service-level Reddit Crypto market sentiment across all tracked assets.
  - `buzz_score` number, 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).
  - `mentions` integer, required — Total Reddit mentions across the selected period, including inherited thread-context mentions
  - `unique_posts` integer, required — Exact distinct Reddit post count across the selected UTC period
  - `subreddit_count` integer, required — Distinct subreddits contributing in the selected period
  - `total_upvotes` integer, required — Total upvotes across attributed mentions in the selected period
  - `active_tickers` integer, required — Number of crypto symbols with activity in the selected period
  - `sentiment_score` number, nullable — Service-wide average sentiment score across the selected period
  - `positive_count` integer, required — Deprecated. Prefer bullish_pct with mentions for public analysis; retained for v1 compatibility.
  - `negative_count` integer, required — Deprecated. Prefer bearish_pct with mentions for public analysis; retained for v1 compatibility.
  - `neutral_count` integer, required — Deprecated. Prefer bullish_pct, bearish_pct and mentions for public analysis; retained for v1 compatibility.
  - `bullish_pct` integer, required — Bullish mention percentage
  - `bearish_pct` integer, required — Bearish mention percentage
  - `trend_history` number[] — 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.
  - `drivers` CryptoMarketSentimentDriver[] — Top assets by current buzz_score driving the service-level reading
    - `symbol` string, required — Crypto symbol
    - `mentions` integer, required — Attributed Reddit mentions in the selected period, including inherited thread-context mentions
    - `buzz_score` number, nullable, required — Asset buzz score in the selected period
    - `sentiment_score` number, nullable — Average sentiment score for this asset

## Other responses

- `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/revisions/351caf64ba81/schema)