Token dumb money sentiment

Parameters

id string PATH required

Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

Example:bitcoin

hours integer QUERY

Lookback window in hours.

Example:168

granularity string QUERY

Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

Allowed values

1h2h4h12h1d

Example:1h

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/dumb-money-sentiment' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

data

array<object> optional

Dumb-money sentiment series only.

data[].bearish_posts

number (double) optional

Count of bearish posts included in the computed window.

data[].bucket_start

string (date-time) optional

UTC bucket start timestamp.

data[].bullish_posts

number (double) optional

Count of bullish posts included in the computed window.

data[].interval_bearish_posts

number (double) optional

Bearish posts in the current emitted interval bucket.

data[].interval_bullish_posts

number (double) optional

Bullish posts in the current emitted interval bucket.

data[].interval_neutral_posts

number (double) optional

Neutral posts in the current emitted interval bucket.

data[].interval_posts

number (double) optional

Posts in the current emitted interval bucket.

data[].neutral_posts

number (double) optional

Count of neutral posts included in the computed window.

data[].sentiment_score

number (double) optional

Sentiment score on a 0-100 scale (higher is more bullish).

data[].sentiment_score_smoothed

number (double) optional

Smoothed sentiment score (0-100) when available.

data[].sentiment_score_z

number (double) optional

Z-score normalized sentiment where available.

data[].sentiment_signal

number (double) optional

Model-level sentiment signal used for downstream ranking when available.

data[].total_posts

number (double) optional

Total posts included in the computed window.

data[].total_posts_smoothed

number (double) optional

Smoothed total-posts series where available.

{
  "data": [
    {
      "bearish_posts": 0,
      "bucket_start": "2026-01-15T12:00:00Z",
      "bullish_posts": 0,
      "interval_bearish_posts": 0,
      "interval_bullish_posts": 0,
      "interval_neutral_posts": 0,
      "interval_posts": 0,
      "neutral_posts": 0,
      "sentiment_score": 0,
      "sentiment_score_smoothed": 0,
      "sentiment_score_z": 0,
      "sentiment_signal": 0,
      "total_posts": 0,
      "total_posts_smoothed": 0
    }
  ]
}