Reddit Crypto

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

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Path parameters

symbolstring required

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

Query parameters

fromstring date nullable

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.

limitinteger

Maximum number of raw mentions to return

offsetinteger

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

include_inheritedboolean

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
    }
  ]
}

Changes