Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token long/short ratio

GET /token/{id}/long-short-ratio

Starter

Counts of unique long vs short callers over time for the token.

id

stringrequired

Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

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.

Media type: application/json

data

array<object> optional

Time series of long/short caller counts.

data[].long_callers

integer (int64) optional

Unique callers with bullish/long stance in the bucket.

data[].short_callers

integer (int64) optional

Unique callers with bearish/short stance in the bucket.

data[].time

string (date-time) optional

UTC timestamp for the data point.

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

200 · application/json

{
  "data": [
    {
      "long_callers": 0,
      "short_callers": 0,
      "time": "2026-01-15T12:00:00Z"
    }
  ]
}