Token Fear and Greed index

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

debug boolean QUERY

Set true to include diagnostic fields in the response.

Example:string

cURL Example

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

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

current

object optional

Latest Fear and Greed index value.

current.index

number (double) optional

Index value (typically 0-100 scale).

current.label

string optional

Human-readable label for the index regime.

debug

object optional

Optional diagnostics included only when debug=true.

metadata

object optional

Model metadata and component weights.

metadata.components

array<object> optional

Model components contributing to the index.

metadata.components[].description

string optional

No description provided.

metadata.components[].name

string optional

Display name.

metadata.components[].weight

number (double) optional

No description provided.

metadata.hours

integer optional

Lookback window in hours used to compute the metric.

metadata.labels

array<string> optional

Human-readable labels for index regimes.

metadata.scale

string optional

No description provided.

metadata.token_id

integer (int64) optional

Internal token identifier.

series

array<object> optional

Fear and Greed index time series.

series[].absolute_momentum

number (double) optional

Composite absolute momentum component.

series[].debug_mom_long

integer optional

No description provided.

series[].debug_mom_short

integer optional

No description provided.

series[].debug_sent_long

integer optional

No description provided.

series[].debug_sent_short

integer optional

No description provided.

series[].debug_vol_long

integer optional

No description provided.

series[].debug_vol_short

integer optional

No description provided.

series[].emotions

number (double) optional

No description provided.

series[].immediate_momentum

number (double) optional

Momentum contribution from the most recent window.

series[].immediate_sentiment

number (double) optional

Sentiment contribution from the most recent window.

series[].immediate_volume

number (double) optional

Volume contribution from the most recent window.

series[].index

number (double) optional

Index value (typically 0-100 scale).

series[].label

string optional

Human-readable label for the index regime.

series[].long_abs_momentum

number (double) optional

Long-horizon absolute momentum component.

series[].long_rel_momentum

number (double) optional

Long-horizon relative momentum component.

series[].momentum

number (double) optional

No description provided.

series[].post_volume

number (double) optional

Post volume used in the Fear and Greed index calculation.

series[].relative_momentum

number (double) optional

Composite relative momentum component.

series[].relative_volume

number (double) optional

Relative social or trading volume vs baseline.

series[].sentiment

number (double) optional

No description provided.

series[].short_abs_momentum

number (double) optional

Short-horizon absolute momentum component.

series[].short_rel_momentum

number (double) optional

Short-horizon relative momentum component.

series[].social_volume_multiplier

number (double) optional

Multiplier capturing how elevated social volume is vs baseline.

series[].time

string (date-time) optional

UTC timestamp for the data point.

series[].volatility

number (double) optional

No description provided.

{
  "current": {
    "index": 42.7,
    "label": "Fear"
  },
  "metadata": {
    "components": [
      {
        "description": "Volatility component on a 0-100 greed scale.",
        "name": "volatility",
        "weight": 0.16
      }
    ],
    "hours": 168,
    "labels": [
      "Extreme Fear (0-24)",
      "Fear (25-49)",
      "Greed (50-74)",
      "Extreme Greed (75-100)"
    ],
    "scale": "0-100",
    "token_id": 1
  },
  "series": [
    {
      "index": 42.7,
      "label": "Fear",
      "time": "2026-01-15T00:00:00Z"
    }
  ]
}