Sentiment Ratio

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