Token mindshare

GET /token/{id}/mindshare

GetTokenIdMindshare

Mindshare (social attention) time-series for the token. Optionally scope to a subset of social clusters via `clusters` (repeatable): with no clusters it's the token's share of all crypto attention; with clusters it's the token's share of attention within those clusters.

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

clusters array<string> QUERY

Optional. Repeatable. Scope the metric to a subset of social clusters (the union of the ids). Omit for ALL. Ids: smart_money, dumb_money, top_degens (caller-list, token-only), plus author clusters (developers, founders, team_leaders, project_accounts, vcs, asset_managers, dao_guild_funds, incubators, exchanges, kols, celebrities, media, marketer, shiller, ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators, position_trader, swing_trader, day_trader, tribalist, perma_bull, doomer, political, nft, bots, automated_ai).

Example:string

cURL Example

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

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

mindshare

array<object> optional

Token social mindshare series.

mindshare[].time

string (date-time) optional

UTC timestamp for the data point.

mindshare[].value

number (double) optional

Numeric metric value for the timestamp.

{
  "mindshare": [
    {
      "time": "2026-01-15T12:00:00Z",
      "value": 0
    }
  ]
}