Token sentiment timeframes

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/sentiment-timeframes' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

metadata

object optional

Computation metadata for timeframe sentiment output.

metadata.as_of

string (date-time) optional

No description provided.

metadata.calculation

string optional

No description provided.

metadata.formula

string optional

No description provided.

metadata.half_life_h

number (double) optional

No description provided.

metadata.handle

string optional

No description provided.

metadata.handles

array<string> optional

Normalized handles used by the query.

metadata.lookback_days

integer optional

No description provided.

metadata.scale

string optional

No description provided.

metadata.token_id

integer (int64) optional

Internal token identifier.

series

object optional

Sentiment time series split by timeframe buckets (short, medium, long).

summary

object optional

Current summary sentiment by timeframe key.

{
  "metadata": {
    "as_of": "2026-01-15T12:00:00Z",
    "calculation": "string",
    "formula": "string",
    "half_life_h": 0,
    "handle": "string",
    "handles": [
      "string"
    ],
    "lookback_days": 0,
    "scale": "string",
    "token_id": 0
  },
  "series": {},
  "summary": {}
}