> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mindshare API

> Track crypto narrative mindshare, token attention, rolling windows, watchlist growth, and historical snapshots through the API.

Track each crypto narrative's watchlist share, token-level watchlist rows, rolling windows, and historical mindshare snapshots.

## Get mindshare data

`GET /v1/mindshare/data`

Query parameters:

* `tokens`: set to `true` for token rows.
* `narrative`: optional narrative slug.
* `historical`: set to `true` for historical snapshots.
* `timeframe`: `1W`, `1M`, `3M`, `6M`, `1Y`, or `3Y`.
* `window`: `now`, `24h`, `7d`, or `30d`.

Shares and returns are fractions: `0.3573` is 35.73%.

`sentiment` is a share from `0` to `1` only when CoinGecko returned a sentiment
sample. It is `null` when the sample is unavailable; `null` does not mean
neutral `0.5`.

`mindshare` is each narrative's share of CoinGecko watchlist users (formula v3,
2026-10-31; up-votes are not weighted), as in the historical snapshots'
`mindshare`. `mindshareChange24h` is always `null`: coin watchlist counts are
cached 5-8 days. `mindshareChange7d` and `mindshareChange30d` are differences of
two shares (`0.3566` to `0.3557` is `-0.0009`), not relative changes. They
compare against snapshots no older than 2026-10-19 (the narrative coin-list
change), so `mindshareChange30d` is `null` until 2026-11-18, and either can
trail the true move by up to one 5-8 day refresh.

```bash theme={null}
curl -G https://www.sharpe.ai/api/v1/mindshare/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  --data-urlencode "window=7d"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.