# Token top degens sentiment

- Method: `GET`
- Path: `/token/{id}/top-degens-sentiment`
- Tier: Pro
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-token-id-top-degens-sentiment/
- Interactive docs: https://docs.hiddensystems.ai/nebula/#endpoint=get-token-id-top-degens-sentiment

## Description

Sentiment time-series from top degens cohort only.

## cURL Example

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

## Path Parameters

- `id` (string, required): Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

## Query Parameters

- `hours` (integer, optional): Lookback window in hours.
- `granularity` (string, optional): Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

## Response

OK

- `data` (array<object>): Top-degens sentiment series only.
- `data[].bearish_posts` (number (double)): Count of bearish posts included in the computed window.
- `data[].bucket_start` (string (date-time)): UTC bucket start timestamp.
- `data[].bullish_posts` (number (double)): Count of bullish posts included in the computed window.
- `data[].interval_bearish_posts` (number (double)): Bearish posts in the current emitted interval bucket.
- `data[].interval_bullish_posts` (number (double)): Bullish posts in the current emitted interval bucket.
- `data[].interval_neutral_posts` (number (double)): Neutral posts in the current emitted interval bucket.
- `data[].interval_posts` (number (double)): Posts in the current emitted interval bucket.
- `data[].neutral_posts` (number (double)): Count of neutral posts included in the computed window.
- `data[].sentiment_score` (number (double)): Sentiment score on a 0-100 scale (higher is more bullish).
- `data[].sentiment_score_smoothed` (number (double)): Smoothed sentiment score (0-100) when available.
- `data[].sentiment_score_z` (number (double)): Z-score normalized sentiment where available.
- `data[].sentiment_signal` (number (double)): Model-level sentiment signal used for downstream ranking when available.
- `data[].total_posts` (number (double)): Total posts included in the computed window.
- `data[].total_posts_smoothed` (number (double)): Smoothed total-posts series where available.

Media type: `application/json`

## JSON Response

```json
{
  "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
    }
  ]
}
```