# Token follower history

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

## Description

Total follower counts over time for the token. Query by days.

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/follower-history' \
  --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

- `days` (integer, optional): Lookback window in days.

## Response

OK

- `data` (array<object>): Follower history points for tracked project/handle accounts.
- `data[].followers_count` (integer (int64)): Total followers at the snapshot timestamp.
- `data[].snapshot_at` (string (date-time)): UTC timestamp of the follower snapshot.

Media type: `application/json`

## JSON Response

```json
{
  "data": [
    {
      "followers_count": 0,
      "snapshot_at": "2026-01-15T12:00:00Z"
    }
  ]
}
```