Academy

    Getting started

    • For Traders
    • For Developers
  • Guides

    Resources

  • Home
  • Metrics
  • Social Volume

    Social Volume

    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


    Change Metrics

    Change Metrics


    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
    • twitter
    • bitcointalk
    • 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

    Updated 1 month ago

    Talk to us in Discord

    Still have some questions left? Join our Discord and get help from the Santiment team!

    Go to Discord
    © 2016—2023 Santiment
    TermsPrivacyMedia KitStatusChangelog

    Santiment on social media

    © 2016—2023 Santiment