# Token sentiment timeframes

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

## Description

Sentiment broken down by short/medium/long timeframes.

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/sentiment-timeframes' \
  --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

- `metadata` (object): Computation metadata for timeframe sentiment output.
- `metadata.as_of` (string (date-time)): No description provided.
- `metadata.calculation` (string): No description provided.
- `metadata.formula` (string): No description provided.
- `metadata.half_life_h` (number (double)): No description provided.
- `metadata.handle` (string): No description provided.
- `metadata.handles` (array<string>): Normalized handles used by the query.
- `metadata.lookback_days` (integer): No description provided.
- `metadata.scale` (string): No description provided.
- `metadata.token_id` (integer (int64)): Internal token identifier.
- `series` (object): Sentiment time series split by timeframe buckets (short, medium, long).
- `summary` (object): Current summary sentiment by timeframe key.

Media type: `application/json`

## JSON Response

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