すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. ソーシャル & センチメント

ソーシャルモメンタム

GET /social-momentum
GetSocialMomentum

資産、トピック、または市場全体について、各投稿者クラスター内の投稿、ユニーク投稿者、センチメントを並べて比較できます。どのグループが会話を牽引しているのか、またそのトーンがどう異なるのかがわかります。クラスターは重複するため、合計しないでください。指定したクラスターのみを返すには clusters を送信します。

パラメータのルール:

  • asset_id は asset_class と一緒に送信する必要があります。
  • subject_id は asset_id または asset_class と組み合わせることはできません。
  • asset_id を指定しない場合、asset_class は equity または crypto である必要があります。commodity と index には asset_id が必要です。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/social-momentum で利用できます。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（株式、コモディティ、インデックス。デフォルト）または crypto。

指定可能な値
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

/subjects または /search が返す正規の非資産識別子（例: text:jensen huang、handle:elonmusk）。大文字と小文字は区別されません。asset_id または asset_class と組み合わせることはできません。

Example:text:jensen huang

hours integer QUERY

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

Default:168

granularity string QUERY

要求された時系列バケットサイズ。省略した場合、サービスはルックバック期間に適したバケットサイズを選択します。

指定可能な値
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

これらのクラスターのみをそれぞれ独立した系列として返します。省略するとすべてが対象になります。/sentiment の clusters パラメータの id を使用しますが、投稿コミュニティは除きます。

Example:smart_money

cURL の例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/social-momentum' \
  --header 'X-API-Key: YOUR_API_KEY'

レスポンス

200 OK
400 不正なリクエスト
401 未認証
402 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

clusters
object 必須

正規の投稿者クラスター識別子をキーとするソーシャルモメンタム系列。
clusters.{key}[].average_sentiment_score
number (double) 必須

投稿のセンチメントスコアの算術平均。−100（非常に弱気）から +100（非常に強気）のスケールです。

clusters.{key}[].bearish_posts
integer (int64) 必須

弱気と分類された投稿。

clusters.{key}[].bullish_posts
integer (int64) 必須

強気と分類された投稿。

clusters.{key}[].neutral_posts
integer (int64) 必須

中立と分類された投稿。

clusters.{key}[].timestamp
string (date-time) 必須

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

clusters.{key}[].total_posts
integer (int64) 必須

指標の有効な参照ウィンドウ内の投稿数。

clusters.{key}[].unique_posters
integer (int64) 必須

バケット内の重複のない投稿アカウント数。時間単位より粗い粒度では、時間単位のカウントを合計した上限値になります。

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}