# Token mindshare

- Method: `GET`
- Path: `/token/{id}/mindshare`
- Tier: Basic
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-token-id-mindshare/
- Interactive docs: https://docs.hiddensystems.ai/nebula/#endpoint=get-token-id-mindshare

## Description

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.

## cURL Example

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

## Path Parameters

- `id` (string, required): Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

## Query Parameters

- `hours` (integer, optional): Lookback window in hours.
- `granularity` (string, optional): Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.
- `clusters` (array<string>, optional): 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).

## Response

OK

- `mindshare` (array<object>): Token social mindshare series.
- `mindshare[].time` (string (date-time)): UTC timestamp for the data point.
- `mindshare[].value` (number (double)): Numeric metric value for the timestamp.

Media type: `application/json`

## JSON Response

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