---
title: "Service statistics"
method: GET
path: "/reddit/stocks/v1/stats"
tags: ["Reddit Stocks"]
---

# Service statistics

`GET /reddit/stocks/v1/stats`

Returns high-level Reddit stock dataset coverage metrics for questions like:
- how many stock mention rows are stored
- how many distinct tickers currently have Reddit data
- how many mention rows and distinct tickers are present today (UTC)
- how many supported tickers exist in the reference universe

The current-day counters count all rows in `reddit_mentions` since UTC midnight,
including post mentions, comment mentions and inherited thread-context mentions.

## Response `200`

Successful Response

- RedditStatsResponse — Service statistics.
  - `total_mentions` integer, required — Rollup-backed all-time stock mention total; current-day raw rows may be used only as a bounded freshness fallback
  - `unique_tickers` integer, required — Number of unique tickers with mentions
  - `mentions_today` integer — Stock mention rows created since today's UTC midnight, including posts, comments and inherited thread-context mentions
  - `unique_tickers_today` integer — Unique tickers (detected using case-sensitive, uppercase-only patterns) including posts, comments and inherited thread-context mentions
  - `supported_tickers` integer, required — Number of supported ticker patterns (from ticker_reference)

## Other responses

- `401` — Authentication failed
- `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)