Definition

Social Volume is build on top of the Social Data.

The total number of text documents that contain the given search term at least once. Examples of documents are telegram messages and reddit posts. If a single short telegram message includes the word crypto more than once, this message will increase the social volume of the word crypto by 1. If a long reddit post contains the word crypto 10 times, this again will increase the social volume of the word crypto by 1.

Social Volume can be computed for an asset or for arbitrary search terms. When an asset is used, a special search term is constructed. For example querying the social volume for santiment will result in a search term similar to:

(SAN OR santiment OR santoken OR santimentnet OR sancoin OR sansan OR sancoin) AND NOT ((san AND francisco) OR (san AND fran) OR (san AND diego) OR (san AND marino) OR (san AND jose))

which includes documents containg santiment or san but excludes documents that contain common phrases containing san like San Francisco.

The arbitrary search term can be:

  • One particular word like bitcoin, crypto or blockchain.
  • An exact phrase (surrounded by double quotation marks) like "when moon", "buy high sell low" or "btc rekt".
  • Lucene Query - a search term that allows for logical operators. Examples:

    • OR - The union of two search results. btc OR bitcoin returns the documents that contain at least one of the words btc and bitcoin
    • AND - The intersection of two search results. btc AND moon returns the documents that contain both of the words btc and moon at the same time.
    • NOT - Filter out documents that contain a given search term. btc NOT lambo returns the documents that contain the word btc and does not contain the word lambo
    • ? - A wildcard search. ? in the search term means that it can match any character. For example the query btc AND 1?k will be the combined result of btc AND 10k, btc AND 11k, ..., btc AND 19k (but also nonsense like btc AND 1sk, btc AND 1Ak, etc. will be matched)
    • Many other operators can be used, documentation for which can be found in the lucene query syntax documentation.

The operators can be combined and higher precedence can be expressed by using parentheses (btc OR bitcoin) AND moon NOT lambo - it will result in all the documents that contain either the words btc and moon or the words bitcoin and moon in one document, excluding any documents that contain the word lambo.


Access

Restricted Access.


Measuring Unit

Amount of documents that mention the given text pattern.


Data Type

Timeseries Data


Frequency

Five-Minute Intervals


Latency

Social Data Latency


Available Assets

Available for these assets

Note: social_volume_total metric and all metrics for a specific source are available for the same set of assets.


Sanbase

Combined Social Volume from all sources for an asset can be seen on a project's page.

Social Volume for arbitrary search terms can be viewed from the trends page trends page

The combined social volume from all sources is displayed. From the bottom of the page social volume for a specific source can be displayed, too. social volume
search term

SanAPI

Available under the social_volume_total and social_volume_total_<source> names, where the available sources are:

  • telegram
  • reddit
  • discord
  • professional_traders_chat
  • total (combines all sources)

Social Volume for an asset

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  getMetric(metric: "social_volume_total") {
    timeseriesData(
      selector: { slug: "santiment" }
      from: "2020-01-01T00:00:00Z"
      to: "2020-01-07T00:00:00Z"
      interval: "1d"
    ) {
      datetime
      value
    }
  }
}

Run in Explorer


Social Volume for arbitrary search term

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  getMetric(metric: "social_volume_telegram") {
    timeseriesData(
      selector: { text: "btc AND 1?k" }
      from: "2020-01-01T00:00:00Z"
      to: "2020-01-07T00:00:00Z"
      interval: "1d"
    ) {
      datetime
      value
    }
  }
}

Run in Explorer

Was this article helpful?