センチメント

GET /sentiment
GetSentiment

資産、トピック、または市場全体についての会話がどれだけ強気か弱気かを時系列で示します。sentiment_signal は直近 24 時間の強気投稿から弱気投稿を引いた値で、最近の投稿ほど重み付けが大きく、正の値は純強気を意味します。投稿量に応じて大きくなるため、資産は自身の履歴と比較してください。

cohorts はボット、および単一の資産またはトピックについてはトップコーラーについて同じ指標を示します。1 つ以上の著者グループを読み取るには 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/sentiment で利用できます。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

読み取る投稿者クラスター。繰り返し指定して組み合わせられます(例: clusters=kols&clusters=media)。選択したクラスターは合算され、1 人の投稿者が複数のクラスターに属することもあります。

  • Callers: smart_money(成績の良い Caller)、dumb_money(成績の悪い Caller)、top_degens(小型暗号資産で好成績)
  • Timing: early_movers(注目が高まる中でいち早くアセットについて言及する)、late_movers(ピーク時またはそれ以降に到達する)
  • Builders: developers、founders、team_leaders、project_accounts
  • Institutions: vcs、asset_managers、dao_guild_funds、incubators、exchanges
  • Influence: kols、celebrities、media、marketer、shiller
  • Analysts: ta_analyst、fa_analyst、macro_analyst、onchain_analyst、investigators
  • Traders: position_trader、swing_trader、day_trader
  • Bias: perma_bull、doomer、tribalist
  • Other: political、nft、bots、automated_ai
  • Communities(投稿された場所別): wallstreetbets、reddit

Example:smart_money

cURL の例

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

レスポンス

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

メディアタイプ application/json

cohorts
object 必須

他の著者グループ(ボット、およびその母集団が利用可能な場合は top_callers)についての同じ指標。非ボットの母集団は series そのものです。

許可されるキー
botstop_callers
cohorts.{key}[].bearish_posts
number (double) 必須

この時点で終わる直近 24 時間の弱気投稿。interval_bearish_posts はこのバケットの値です。

cohorts.{key}[].bullish_posts
number (double) 必須

この時点で終わる直近 24 時間の強気投稿。interval_bullish_posts はこのバケットの値です。

cohorts.{key}[].interval_bearish_posts
number (double) 任意

この出力された時間バケット内の弱気投稿。

cohorts.{key}[].interval_bullish_posts
number (double) 任意

この出力された時間バケット内の強気投稿。

cohorts.{key}[].interval_neutral_posts
number (double) 任意

この出力された時間バケット内の中立投稿。

cohorts.{key}[].interval_posts
number (double) 任意

この出力された時間バケット内の投稿(ルックバックの累積前)。

cohorts.{key}[].neutral_posts
number (double) 必須

この時点で終わる直近 24 時間の中立投稿。interval_neutral_posts はこのバケットの値です。

cohorts.{key}[].sentiment_signal
number (double) 必須

減衰重み付けされた純強気投稿数(強気から弱気を引いた値)。正は強気、負は弱気で、値の大きさはアクティビティとともに増加します。

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

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

cohorts.{key}[].total_posts
number (double) 必須

この時点で終わる直近 24 時間の投稿(このバケット単体ではない)。interval_posts はこのバケットの値です。

series
array<object> 必須

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

series[].bearish_posts
number (double) 必須

この時点で終わる直近 24 時間の弱気投稿。interval_bearish_posts はこのバケットの値です。

series[].bullish_posts
number (double) 必須

この時点で終わる直近 24 時間の強気投稿。interval_bullish_posts はこのバケットの値です。

series[].interval_bearish_posts
number (double) 任意

この出力された時間バケット内の弱気投稿。

series[].interval_bullish_posts
number (double) 任意

この出力された時間バケット内の強気投稿。

series[].interval_neutral_posts
number (double) 任意

この出力された時間バケット内の中立投稿。

series[].interval_posts
number (double) 任意

この出力された時間バケット内の投稿(ルックバックの累積前)。

series[].neutral_posts
number (double) 必須

この時点で終わる直近 24 時間の中立投稿。interval_neutral_posts はこのバケットの値です。

series[].sentiment_signal
number (double) 必須

減衰重み付けされた純強気投稿数(強気から弱気を引いた値)。正は強気、負は弱気で、値の大きさはアクティビティとともに増加します。

series[].timestamp
string (date-time) 必須

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

series[].total_posts
number (double) 必須

この時点で終わる直近 24 時間の投稿(このバケット単体ではない)。interval_posts はこのバケットの値です。

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}