> ## 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 | Mindshare-and-sentiment-dataset |
| 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/mindshare-sentiment/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/mindshare-sentiment/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/mindshare-sentiment/timeseries-asset-sentiment-by-id) for the response and the errors.


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