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

# Asset Sentiment

> Social sentiment for an asset, a score from -1 to 1 derived from posts on X, with the number of posts counted. Each series is one asset, keyed by its asset id.

|                  |                                                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Access           | Social\_mindshare\_unified                                                                                                |
| Timeseries model | `asset-sentiment`: intervals `1h`, `6h`, `1d`, series key `asset-id` (Asset ID), series must be named (up to 20 per call) |

## Endpoints

<CardGroup cols={2}>
  <Card title="Batch Get Asset timeseries" icon="arrow-right" href="/api-reference/data-api/social-mindshare/timeseries-asset-sentiment">
    Up to 20 series in one request, named by Asset ID in `series`.
  </Card>

  <Card title="Get Asset timeseries" icon="arrow-right" href="/api-reference/data-api/social-mindshare/timeseries-asset-sentiment-by-id">
    One series over a time window, keyed by its Asset ID.
  </Card>
</CardGroup>

## Metrics

2 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field             | Name            | Type    | Unit | Description                                                                                                     |
| ----------------- | --------------- | ------- | ---- | --------------------------------------------------------------------------------------------------------------- |
| `sentiment-score` | Sentiment Score | float64 |      | The sentiment score for the asset. The score ranges from -1.0 (extremely negative) to 1.0 (extremely positive). |
| `tweet-volume`    | Tweet Volume    | int32   |      | The number of tweets for the asset.                                                                             |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/asset-sentiment/1d/1e31218a-e44e-4285-820c-8282ee222035?timeframe=7d&selections=sentiment-score,tweet-volume" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Asset timeseries](/api-reference/data-api/social-mindshare/timeseries-asset-sentiment-by-id) for the response and the errors.