すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. クラスター

投稿者クラスター

GET /clusters
ListClusters

ある市場におけるすべての投稿者クラスターの活動とセンチメント：投稿数、ユニーク投稿者数、前のウィンドウとの変化、および純センチメント（強気の投稿から弱気の投稿を引いたもの）と時間別シリーズ。asset_class は equity（デフォルト）または crypto です。

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

パラメータ

asset_class string QUERY

集計する市場：equity（株式、コモディティ、指数をまとめて対象とする伝統的市場）または crypto。

指定可能な値
equitycrypto

Default:equity

hours integer QUERY

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

Default:24

cURL の例

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

レスポンス

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

メディアタイプ application/json

clusters
array<object> 必須

選択した資産クラスの投稿者クラスター概要。
clusters[].activity_change_pct
number (double) 任意

同じ長さの前のウィンドウに対する投稿数の変化率（84の後に76なら -9.52）。比較できない場合は存在しません。

clusters[].bearish_posts
number (double) 必須

弱気と分類された投稿。

clusters[].bullish_posts
number (double) 必須

強気と分類された投稿。

clusters[].cluster_id
string 必須

投稿者クラスターの正規識別子。

clusters[].neutral_posts
number (double) 必須

中立と分類された投稿。

clusters[].previous_total_posts
number (double) 必須

同じ長さの直前のウィンドウにおける投稿数。

clusters[].recent_sentiment_signal
number (double) 必須

時間別センチメントシリーズの最新値：投稿がある直近の時間。

clusters[].series
array<object> 必須

時系列順に並んだ観測値。
clusters[].series[].bearish_posts
number (double) 必須

弱気と分類された投稿。

clusters[].series[].bullish_posts
number (double) 必須

強気と分類された投稿。

clusters[].series[].sentiment_signal
number (double) 必須

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

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

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

clusters[].series[].total_posts
number (double) 必須

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

clusters[].total_posts
number (double) 必須

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

clusters[].window_sentiment_signal
number (double) 必須

要求されたウィンドウ全体における純強気センチメントシグナル。

hours
integer 必須

レスポンスが対象とするルックバック期間（時間単位）。

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}