Categorized Social Volume

Definition

Twitter/X.com Social Volume can be broken down by account category. Categorized Social Volume ships as a set of per-category metrics, each following the pattern social_volume_twitter_<category>.

Each metric counts social data text documents posted by accounts in a defined category that mention the given asset. Document-counting mechanic (tweets/replies, “posted by” attribution) is carried over from how Social Volume counts documents.

See Categorized Social Volume Details for what accounts fall into each category, how assignment works, and how often it is reviewed.

Like Social Volume, data for these metrics may be supplemented with new data within a 12-hour period after it is first recorded.

These metrics are currently in beta status.


Access

Restricted Access.

As of this writing, the SanAPI returns the following error for every asset covered by these metrics, regardless of subscription tier:

The metric social_volume_twitter_btc_maxi is currently in beta phase and is exclusively available to select users.


Measuring Unit

Amount of documents posted by accounts in the category that mention the given asset.


Data Type

Timeseries Data


Change Metrics

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


Frequency

Five-Minute Intervals


Latency

Social Data Latency


Available Assets

Available for these assets.

All seven category metrics share the same 215-asset set, which is a subset of the 2,816 assets available for Social Volume.


SanAPI

Available under the following names:

  • social_volume_twitter_btc_maxi
  • social_volume_twitter_builder
  • social_volume_twitter_kol
  • social_volume_twitter_media
  • social_volume_twitter_memecoins
  • social_volume_twitter_trader
  • social_volume_twitter_trading_firm

Categorized Social Volume for an Asset

{
getMetric(metric: "social_volume_twitter_btc_maxi") {
timeseriesDataJson(
selector: { slug: "bitcoin" }
from: "2025-09-01T00:00:00Z"
to: "2025-09-07T00:00:00Z"
interval: "1d"
)
}
}

As of this writing, this query returns the beta-access error described under Access instead of data.


Full List of Metrics

The full list of Categorized Social Volume metrics is:

Open Metrics List
  • social_volume_twitter_btc_maxi
  • social_volume_twitter_builder
  • social_volume_twitter_kol
  • social_volume_twitter_media
  • social_volume_twitter_memecoins
  • social_volume_twitter_trader
  • social_volume_twitter_trading_firm