Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token emotions series

GET /token/{id}/emotions-series

Starter

Description

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

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

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"
      }
    ]
  }
}