Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token smart money bias

GET /token/{id}/smart-money-bias

Starter

Description

Current bias (smart money sentiment minus overall sentiment) in basis points.

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 point-in-time smart-money bias metrics.

current.bucket_start

string (date-time) optional

UTC bucket start timestamp.

current.overall_sentiment_score

number (double) optional

Overall sentiment score (0-100).

current.sentiment_bias_bps

number (double) optional

Difference between smart-money and overall sentiment, in basis points.

current.smart_money_sentiment_score

number (double) optional

Smart-money cohort sentiment score (0-100).

cURL Example

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

JSON Response

200 · application/json

{
  "current": {
    "bucket_start": "2026-01-15T12:00:00Z",
    "overall_sentiment_score": 0,
    "sentiment_bias_bps": 0,
    "smart_money_sentiment_score": 0
  }
}