Sentiment Ratio

⚠️

Notice: These metrics are currently available via API only. Sanbase support is coming soon.

Definition

Sentiment Ratio compares Labeled Social Volume counts to show what share of documents fall into each sentiment bucket — positive, neutral, or negative.

Positive Ratio=Positive Docs CountPositive Docs Count+Neutral Docs Count+Negative Docs Count\text{Positive Ratio} = \frac{\text{Positive Docs Count}}{\text{Positive Docs Count} + \text{Neutral Docs Count} + \text{Negative Docs Count}} Neutral Ratio=Neutral Docs CountPositive Docs Count+Neutral Docs Count+Negative Docs Count\text{Neutral Ratio} = \frac{\text{Neutral Docs Count}}{\text{Positive Docs Count} + \text{Neutral Docs Count} + \text{Negative Docs Count}} Negative Ratio=Negative Docs CountPositive Docs Count+Neutral Docs Count+Negative Docs Count\text{Negative Ratio} = \frac{\text{Negative Docs Count}}{\text{Positive Docs Count} + \text{Neutral Docs Count} + \text{Negative Docs Count}}

These metrics are currently in beta status.


Access

Restricted Access.

The metric sentiment_positive_ratio_total is currently in beta phase and is exclusively available to alpha and beta users.


Measuring Unit

Ratio of documents in the given sentiment bucket to all documents, as a number between 0 and 1.


Data Type

Timeseries Data


Change Metrics

No _change_1d, _change_7d, or _change_30d variants exist for these metrics.


Frequency

Each source is available at three frequencies: the plain metric name is computed on five-minute intervals, the _1h suffix on hourly intervals, and the _1d suffix on daily intervals.


Latency

Social Data Latency


Available Assets

Available for these assets.


SanAPI

Available under the sentiment_positive_ratio_total and sentiment_positive_ratio_<source>, sentiment_neutral_ratio_total and sentiment_neutral_ratio_<source>, sentiment_negative_ratio_total and sentiment_negative_ratio_<source> names, where the available sources are:

  • 4chan
  • telegram
  • reddit
  • twitter
  • total (combines all sources)

Each of the names above is also available with a _1h or _1d suffix — see Frequency.

Sentiment Ratio for an Asset

{
getMetric(metric: "sentiment_positive_ratio_total") {
timeseriesDataJson(
selector: { slug: "bitcoin" }
from: "2026-01-01T00:00:00Z"
to: "2026-01-15T00:00:00Z"
interval: "1d"
)
}
}

Full List of Metrics

The full list of Sentiment Ratio metrics is:

Open Positive Sentiment Ratio
  • sentiment_positive_ratio_total
  • sentiment_positive_ratio_total_1d
  • sentiment_positive_ratio_total_1h
  • sentiment_positive_ratio_4chan
  • sentiment_positive_ratio_4chan_1d
  • sentiment_positive_ratio_4chan_1h
  • sentiment_positive_ratio_reddit
  • sentiment_positive_ratio_reddit_1d
  • sentiment_positive_ratio_reddit_1h
  • sentiment_positive_ratio_telegram
  • sentiment_positive_ratio_telegram_1d
  • sentiment_positive_ratio_telegram_1h
  • sentiment_positive_ratio_twitter
  • sentiment_positive_ratio_twitter_1d
  • sentiment_positive_ratio_twitter_1h
Open Neutral Sentiment Ratio
  • sentiment_neutral_ratio_total
  • sentiment_neutral_ratio_total_1d
  • sentiment_neutral_ratio_total_1h
  • sentiment_neutral_ratio_4chan
  • sentiment_neutral_ratio_4chan_1d
  • sentiment_neutral_ratio_4chan_1h
  • sentiment_neutral_ratio_reddit
  • sentiment_neutral_ratio_reddit_1d
  • sentiment_neutral_ratio_reddit_1h
  • sentiment_neutral_ratio_telegram
  • sentiment_neutral_ratio_telegram_1d
  • sentiment_neutral_ratio_telegram_1h
  • sentiment_neutral_ratio_twitter
  • sentiment_neutral_ratio_twitter_1d
  • sentiment_neutral_ratio_twitter_1h
Open Negative Sentiment Ratio
  • sentiment_negative_ratio_total
  • sentiment_negative_ratio_total_1d
  • sentiment_negative_ratio_total_1h
  • sentiment_negative_ratio_4chan
  • sentiment_negative_ratio_4chan_1d
  • sentiment_negative_ratio_4chan_1h
  • sentiment_negative_ratio_reddit
  • sentiment_negative_ratio_reddit_1d
  • sentiment_negative_ratio_reddit_1h
  • sentiment_negative_ratio_telegram
  • sentiment_negative_ratio_telegram_1d
  • sentiment_negative_ratio_telegram_1h
  • sentiment_negative_ratio_twitter
  • sentiment_negative_ratio_twitter_1d
  • sentiment_negative_ratio_twitter_1h