ソーシャルと取引量の比較

GET /social-volume-index

GetSocialVolumeIndex

ある資産について、取引と会話のどちらがより熱くなっているかを、それぞれ自身の90日間の平常値と比較して示します。volume_indexは0〜100で、50は両者が同程度に高まっていることを意味し、50を超えると取引が会話を上回り、50を下回ると会話が取引を上回ります。日次で、最大90日分です。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/social-volume-index で利用できます。Nebula アカウントや API キーは不要です。署名する前に支払いオファーを確認してください。x402 支払いガイド。

パラメータ

asset_id string QUERY 必須

/assets または /search で取得したアセット ID（NVDA、GLD、SPX、bitcoin など）。一緒に返された asset_class とともに送信してください。

Example:NVDA

asset_class string QUERY 必須

asset_id で指定されたアセットのクラス: equity（株式および ETF）、commodity、index、crypto のいずれか。/assets または /search が asset_id とともに返した asset_class を送信してください。

指定可能な値

equitycommodityindexcrypto

Example:equity

hours integer QUERY

遡及ウィンドウ（時間単位）。無料プランでは 90 日まで遡及できます。それより前を指定すると 403 が返されます。

Default:2160

cURL の例

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'

レスポンス

200 OK

400 不正なリクエスト

401 未認証

402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます

403 アクセス拒否

404 見つかりません

405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。

429 リクエストが多すぎます

500 内部サーバーエラー

503 サービス利用不可

メディアタイプ application/json

series

array<object> 必須

時系列順に並んだ観測値。

series[].posts

number (double) 必須

当日のその資産の投稿数。ボットは除外しています。

series[].social_relative

number (double) 必須

直近7日間のその資産の投稿数を、過去90日間における7日間投稿数の中央値の倍数として表したもの。1が平常です。

series[].timestamp

string (date-time) 必須

観測値またはバケット開始時点の UTC RFC 3339 タイムスタンプ。

series[].trading_relative

number (double) 必須

直近7日間のその資産のドル建て取引量を、過去90日間における7日間取引量の中央値の倍数として表したもの。1が平常です。

series[].volume_index

number (double) 必須

0〜100：50は取引と会話がそれぞれの平常値に対して同程度に高まっていることを意味し、50を超えると取引が会話を上回り、50を下回ると会話が取引を上回ります。

series[].volume_usd

number (double) 必須

当日のその資産のドル建て取引量。取引のない日（株式の週末など）は0です。

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