Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token emotions series

GET /token/{id}/emotions-series

GetTokenIdEmotionsSeries

Emotion distribution (joy, fear, etc.) over time for the token.

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

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

series

object optional

Per-emotion time series keyed by emotion label.

Allowed keys

angeranticipationboredomconfidencedisgustdistrustfeargreedjoyloveoptimismpessimismsadnesssurprisetrust

cURL Example

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

JSON Response

200 · application/json

{
  "series": {
    "anger": [
      {
        "proportion": 0.08,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "anticipation": [
      {
        "proportion": 0.04,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "boredom": [
      {
        "proportion": 0.01,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "confidence": [
      {
        "proportion": 0.07,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "disgust": [
      {
        "proportion": 0.01,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "distrust": [
      {
        "proportion": 0.02,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "fear": [
      {
        "proportion": 0.15,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "greed": [
      {
        "proportion": 0.2,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "joy": [
      {
        "proportion": 0.25,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "love": [
      {
        "proportion": 0.03,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "optimism": [
      {
        "proportion": 0.06,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "pessimism": [
      {
        "proportion": 0.03,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "sadness": [
      {
        "proportion": 0.02,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "surprise": [
      {
        "proportion": 0.01,
        "time": "2026-01-15T12:00:00Z"
      }
    ],
    "trust": [
      {
        "proportion": 0.02,
        "time": "2026-01-15T12:00:00Z"
      }
    ]
  }
}