Categorized Social Volume

⚠️

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

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, these metrics are available only to alpha and beta users. Every other account gets the following error for every asset, whatever its subscription plan, Business Max included:

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

getAccessRestrictions still shows these metrics as isAccessible: true for paid plans, because it does not account for the beta restriction.


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