Docs home All endpoints Interactive docs Markdown OpenAPI JSON

Token long/short ratio

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

Counts of unique long vs short callers 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

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.