Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token FOMO/FUD index

GET /token/{id}/fomo-fud-index

Free

Description

FOMO & FUD index time-series for the token (0–100 scale).

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

Media type: application/json

current

object optional

Latest FOMO/FUD 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

No description provided.

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

FOMO/FUD 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 FOMO/FUD 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.

cURL Example

curl --request GET \
  --url 'https://api.ruma.fun/api/v1/public/token/bitcoin/fomo-fud-index' \
  --header 'X-API-Key: YOUR_API_KEY'

JSON Response

200 · application/json

{
  "current": {
    "index": 0,
    "label": "string"
  },
  "debug": {},
  "metadata": {
    "components": [
      {
        "description": "string",
        "name": "string",
        "weight": 0
      }
    ],
    "hours": 0,
    "labels": [
      "string"
    ],
    "scale": "string",
    "token_id": 0
  },
  "series": [
    {
      "absolute_momentum": 0,
      "debug_mom_long": 0,
      "debug_mom_short": 0,
      "debug_sent_long": 0,
      "debug_sent_short": 0,
      "debug_vol_long": 0,
      "debug_vol_short": 0,
      "emotions": 0,
      "immediate_momentum": 0,
      "immediate_sentiment": 0,
      "immediate_volume": 0,
      "index": 0,
      "label": "string",
      "long_abs_momentum": 0,
      "long_rel_momentum": 0,
      "momentum": 0,
      "post_volume": 0,
      "relative_momentum": 0,
      "relative_volume": 0,
      "sentiment": 0,
      "short_abs_momentum": 0,
      "short_rel_momentum": 0,
      "social_volume_multiplier": 0,
      "time": "2026-01-15T12:00:00Z",
      "volatility": 0
    }
  ]
}