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

# Dataset statistics

`GET /reddit/stocks/v1/stats`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/reddit/stocks/v1/stats`
- Auth: API key in header `X-API-Key`

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

Today's counters start at 00:00 UTC and include post, comment and inherited
thread-context mentions.

## Response `200`

Successful Response

- RedditStatsResponse: Service statistics.
  - `total_mentions` integer, required: All-time number of stored Reddit stock mentions
  - `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 stock tickers

## Other responses

- `401`: Authentication failed
- `429`: Rate limit exceeded
- `503`: Database temporarily unavailable
- `504`: Analytics request deadline exceeded

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)