Token social momentum

GET /token/{id}/social-momentum

GetTokenIdSocialMomentum

Per-cluster social momentum: post volume, sentiment split (bullish/bearish/neutral) and unique posters over time, broken out by author cluster (e.g. day_trader, bots, vcs, media). Shows how broadly a token's chatter is spreading across social space and which cohorts drive it. The series is sparse — buckets in which a cluster had no posts are omitted.

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

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/social-momentum' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

clusters

object optional

Momentum series keyed by author-cluster id (e.g. day_trader, bots, vcs, media). Sparse: empty buckets are omitted.

{
  "clusters": {}
}