Social vs trading volume

GET /social-volume-index

GetSocialVolumeIndex

Whether trading or conversation is running hotter for an asset, each measured against its own 90-day normal. volume_index runs 0–100: 50 means both are equally elevated, above 50 trading is ahead of the conversation, below 50 the conversation is ahead of trading. Daily, for up to 90 days.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-index. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

asset_id string QUERY required

Asset ID from /assets or /search, such as NVDA, GLD, SPX, or bitcoin. Send it with the asset_class returned alongside it.

Example:NVDA

asset_class string QUERY required

Class of the asset named by asset_id: equity (stocks and ETFs), commodity, index, or crypto. Send the asset_class that /assets or /search returned alongside the asset_id.

Allowed values

equitycommodityindexcrypto

Example:equity

hours integer QUERY

Lookback window in hours. Free plans reach back 90 days; further returns 403.

Default:2160

cURL Example

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/social-volume-index' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request

401 Unauthorized

402 Credits used up; response includes renewal timing and purchased credit balance

403 Forbidden

404 Not Found

405 Method not allowed; the Allow header lists the supported method

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

series

array<object> required

Chronologically ordered observations.

series[].posts

number (double) required

The asset's posts on the day itself, bots left out.

series[].social_relative

number (double) required

The asset's posts over the trailing 7 days as a multiple of its median 7-day post count over the previous 90 days; 1 is usual.

series[].timestamp

string (date-time) required

UTC RFC 3339 timestamp for the observation or bucket start.

series[].trading_relative

number (double) required

The asset's dollar trading volume over the trailing 7 days as a multiple of its median 7-day volume over the previous 90 days; 1 is usual.

series[].volume_index

number (double) required

From 0 to 100: 50 means trading and conversation are equally elevated against their normal; above 50 trading is ahead of the conversation, below 50 the conversation is ahead of trading.

series[].volume_usd

number (double) required

The asset's dollar trading volume on the day itself; 0 on a day without trading, such as a weekend for a stock.

{
  "series": [
    {
      "posts": 684,
      "social_relative": 1.84,
      "timestamp": "2026-08-07T15:00:00Z",
      "trading_relative": 1.29,
      "volume_index": 41.2,
      "volume_usd": 41250000000
    }
  ]
}