Sign in

v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB
Reddit Crypto

Raw Mentions

Returns raw Reddit mention rows for a specific crypto symbol within the live raw-data retention window. Professional account required. Free and Hobby accounts cannot use this endpoint.

Use this endpoint when you need:

  • post/comment-level snippets
  • original timestamps
  • inherited-context filtering

Notes:

  • Use from and to for explicit UTC date windows
  • Results are ordered newest first and support deterministic offset + limit pagination
  • include_inherited=false by default
  • empty result sets return 200 with results=[]
get/reddit/crypto/v1/token/{symbol}/mentions

Path parameters

symbolstring required

Crypto symbol (e.g., BTC, $ETH, SOL)

Crypto symbol (e.g., BTC, $ETH, SOL)

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

limitinteger

Maximum number of raw mentions to return

Maximum number of raw mentions to return

offsetinteger

Number of raw mention rows to skip for offset-based pagination.

Number of raw mention rows to skip for offset-based pagination.

include_inheritedboolean

Include inherited thread-context mentions in addition to direct symbol matches

Include inherited thread-context mentions in addition to direct symbol matches

Response

Successful Response

symbolstring required

Crypto symbol

period_daysinteger required

Lookback window used for the query

countinteger required

Total number of matching raw rows for the requested include_inherited filter before limit and offset are applied; only the requested page is returned

Example response

{
  "symbol": "BTC",
  "period_days": 7,
  "count": 1,
  "results": [
    {
      "post_id": "abc123",
      "comment_id": "def456",
      "subreddit": "cryptocurrency",
      "author": "user123",
      "text_snippet": "BTC still looks strong above this range...",
      "created_utc": "2026-03-20T18:42:10Z",
      "upvotes": 381,
      "sentiment_score": 0.62,
      "sentiment_label": "positive",
      "is_inherited": false
    }
  ]
}