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

時間軸別センチメント

GET /sentiment/timeframes
GetSentimentTimeframes

人々が話題にしている時間軸ごとに分割したセンチメント。短期（最長1週間）、中期（数週間から数か月）、長期（3か月以上）のそれぞれを /sentiment スケールで示します。今週は弱気だが年間では強気の集団と、一貫して弱気の集団を区別できます。

パラメータのルール:

  • asset_idまたはsubject_idを送信します。
  • asset_id は asset_class と一緒に送信する必要があります。
  • subject_id は asset_id または asset_class と組み合わせることはできません。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes で利用できます。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

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:720

granularity string QUERY

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

指定可能な値
1h2h4h12h1d

Example:1h

cURL の例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment/timeframes' \
  --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

current
object 必須

利用可能な各時間軸の最新センチメント値。

許可されるキー
short_termmedium_termlong_term
metadata
object 任意

レスポンスを解釈するために必要な方法論とリクエスト期間のメタデータ。
metadata.as_of
string (date-time) 任意

指標が計算された時刻（UTC）。

metadata.calculation
string 任意

計算方法の短い名称。

metadata.formula
string 任意

計算式を人間が読める形式で表したもの。

metadata.half_life_hours
number (double) 任意

名前とは裏腹に、線形減衰ウィンドウの長さ（時間単位）。投稿は新しいうちは満点として数えられ、中間点では半分になり、この時間を経過するとまったく数えられません。

metadata.lookback_days
integer 任意

計算で使用する過去の参照期間（日単位）。

metadata.scale
string 任意

公開されている指標のスケールまたは解釈。

series
object 必須

short_term、medium_term、long_term の時間軸をキーとするセンチメント系列。

許可されるキー
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) 任意

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

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

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

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

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

series.{key}[].total_posts
number (double) 任意

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}