API v1 (Legacy)
Reference
GET /reddit_realtime

GET /reddit_realtime

Realtime Reddit mentions and attention feeds.

Authentication

Use the apiKey (or apikey) query parameter.

Parameters

NameTypeRequiredDescription
apiKeystringyesAPI key query parameter (case-insensitive).
symbolstringyesTicker, search string, or special mode (reddit_graph, all_stocks).
datestringnoUsed with symbol=all_stocks for a historical snapshot (YYYY-MM-DD).
subredditstringnoUsed with symbol=all_stocks to scope to a subreddit.
sourcestringnoStocks or Crypto (search mode only).

Behavior Notes

  • symbol=reddit_graph returns per-ticker timelines for the last ~24 hours.
  • symbol=all_stocks returns ranked tickers; date selects a historical day.
  • Otherwise, symbol is treated as a search string (pipe-separated supported), returning hourly mentions and posts.
  • Responses include timezone: "PST".

Example

curl "https://api.altindex.com/reddit_realtime?apiKey=YOUR_API_KEY&symbol=TSLA"

Response Shape (Search Mode)

{
  "status": 200,
  "timezone": "PST",
  "search": "TSLA",
  "data": [
    { "hour": "2026-01-28 14:00:00", "mentions": 3, "sentiment": 0.62 },
    { "hour": "2026-01-28 15:00:00", "mentions": 6, "sentiment": 0.55 }
  ],
  "posts": [
    {
      "text": "TSLA continues to trend...",
      "created": "2026-01-28 14:10:00",
      "score": 52,
      "permalink": "https://reddit.com/r/stocks/...",
      "id": "abc123",
      "key": "2026-01-28 14:00:00"
    }
  ]
}