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

クラスター比較

GET /clusters/comparison
CompareClusters

ウィンドウ全体におけるすべての投稿者クラスターの比較：投稿数とその変化、市場に対する強気度（cluster_bullish_share 対 market_bullish_share）、過去7日間で最も注目した資産（trending_asset）、および日別投稿数。

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

パラメータ

asset_class array<string> QUERY

比較する市場：equity、commodity、index、crypto のいずれかをカンマ区切りで指定。デフォルトは4つすべてです。複数をカンマ区切りで送信してください。

Default:equity,commodity,index,crypto

days integer QUERY

比較する完全な UTC 日数。最新の完全な日から遡って数えます：7、30、または90。activity_change_pct はその同じ日数前と比較します。Free プランは90日前まで遡及可能で、それより前は403を返します。

指定可能な値
73090

Default:30

cURL の例

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

レスポンス

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

メディアタイプ application/json

asset_classes
array<string> 必須

分析された市場。equity、commodity、index、crypto の順：要求された asset_class の値、または asset_class を省略した場合は4つすべて。

clusters
array<object> 必須

ウィンドウ内に投稿があるすべてのクラスター。投稿数の多い順。
clusters[].activity_change_pct
number (double) 必須

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

clusters[].bearish_posts
integer (int64) 必須

ウィンドウ全体におけるクラスターの弱気投稿。

clusters[].bullish_posts
integer (int64) 必須

ウィンドウ全体におけるクラスターの強気投稿。

clusters[].cluster_bullish_share
number (double) 必須

ウィンドウ全体におけるクラスターの強気 ÷（強気 + 弱気）投稿。0から1の範囲。強気または弱気の投稿がない場合は null。

clusters[].cluster_id
string 必須

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

clusters[].market_bullish_share
number (double) 必須

クラスターが読み取る市場の同じ日数・資産クラスにおける同じ割合（投稿コミュニティにとっては equity 市場）：baseline cluster_bullish_share が比較する対象。強気または弱気の投稿がない場合は null。

clusters[].posts
integer (int64) 必須

ウィンドウ全体におけるクラスターの投稿。

clusters[].series
array<object> 必須

ウィンドウ内の完全なUTC日ごと（古い順）。投稿がない日も含みます。
clusters[].series[].bearish_posts
integer (int64) 必須

その日におけるクラスターの弱気投稿。

clusters[].series[].bullish_posts
integer (int64) 必須

その日におけるクラスターの強気投稿。

clusters[].series[].posts
integer (int64) 必須

その日におけるクラスターの投稿。

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

その日のUTC開始時刻：00:00。

clusters[].trending_asset
object 必須

直近7完全日において、市場よりもクラスターがより注目した資産。存在しない場合はnull。
clusters[].trending_asset.asset_class
string 必須

アセットのクラス: equity（株式および ETF）、commodity、index、crypto のいずれか。asset を対象とするすべてのリクエストで asset_id とともに送信してください。

指定可能な値
equitycommodityindexcrypto
clusters[].trending_asset.asset_id
string 必須

公開アセットの正規識別子: 株式、コモディティ、インデックスの場合はティッカーまたは市場シンボル、crypto の場合は CoinGecko スラッグ（スラッグがない場合は数値 id）。

clusters[].trending_asset.name
string 必須

人間が読める名前。

clusters[].trending_asset.symbol
string 必須

表示用のティッカーまたは市場シンボル。

days
integer 必須

完全なUTC日単位のウィンドウ長。最新の完全日で終了します。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}