Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token simple sentiment

GET /token/{id}/simple-sentiment

Free

Description

Simplified sentiment series (summary and cohorts).

Path Parameters

id
stringrequired

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

Query Parameters

hours
integeroptional

Lookback window in hours.

granularity
stringoptionalenum: 1h, 2h, 4h, 12h, 1d

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

Responses

OK

Media type: application/json

cohorts
object optional

Sentiment series by cohort key. Keys are cohort ids as strings.

summary
array<object> optional

Aggregate sentiment series across non-baseline cohorts.

summary[].bearish_posts
number (double) optional

Count of bearish posts included in the computed window.

summary[].bucket_start
string (date-time) optional

UTC bucket start timestamp.

summary[].bullish_posts
number (double) optional

Count of bullish posts included in the computed window.

summary[].interval_bearish_posts
number (double) optional

Bearish posts in the current emitted interval bucket.

summary[].interval_bullish_posts
number (double) optional

Bullish posts in the current emitted interval bucket.

summary[].interval_neutral_posts
number (double) optional

Neutral posts in the current emitted interval bucket.

summary[].interval_posts
number (double) optional

Posts in the current emitted interval bucket.

summary[].neutral_posts
number (double) optional

Count of neutral posts included in the computed window.

summary[].sentiment_score
number (double) optional

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

summary[].sentiment_score_smoothed
number (double) optional

Smoothed sentiment score (0-100) when available.

summary[].sentiment_score_z
number (double) optional

Z-score normalized sentiment where available.

summary[].sentiment_signal
number (double) optional

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

summary[].total_posts
number (double) optional

Total posts included in the computed window.

summary[].total_posts_smoothed
number (double) optional

Smoothed total-posts series where available.