すべてのドキュメント Nebula ドキュメントすべてのエンドポイントインタラクティブドキュメント Markdown OpenAPI JSON

REST API
クラスター

クラスターローテーション

GET /clusters/rotation

GetClusterRotation

あるクラスタの関心がどこへ向かっているか：前のウィンドウと比較して投稿シェアを伸ばしている資産と失っている資産（ベーシスポイント）、および投稿が市場、人物、イベントにどう分かれているか。

パラメータのルール:

cluster_id を送信します。
cluster_id は1つのクラスターを指定します。複数を比較するにはクラスターごとに呼び出すか、/clusters を使って全クラスターを一度に取得してください。
投稿コミュニティ（wallstreetbets、reddit）は株式のみを対象とします。いずれかを指定する場合、asset_class には equity を含める必要があります。

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

パラメータ

cluster_id string QUERY 必須

分析するクラスターを /clusters が返す形式で指定します。例えば smart_money や wallstreetbets です。/sentiment の clusters パラメータで得られる任意の id を使用できます。

Example:smart_money

asset_class array<string> QUERY

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

Default:equity,commodity,index,crypto

hours integer QUERY

同じ長さの直前のウィンドウと比較するウィンドウ：24（直近24時間）、168（直近7完全日）、または720（直近30完全日）。無料プランは90日前まで遡れます。それより前は403を返します。

指定可能な値

24168720

Default:168

limit integer QUERY

返される上昇銘柄の最大数、および別途下落銘柄の最大数。

Default:6

cURL の例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/rotation' \
  --data-urlencode 'cluster_id=smart_money' \
  --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つすべて。

cluster_id

string 必須

分析されたクラスター。正規の cluster_id で示されます。

gainers

array<object> 必須

クラスタの投稿シェアが最も上昇した資産（上昇幅の大きい順）。シェアが上昇した資産のみがリストされます。

gainers[].asset_class

string 必須

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

指定可能な値

equitycommodityindexcrypto

gainers[].asset_id

string 必須

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

gainers[].current_share

number (double) 必須

現在のウィンドウで選択した資産クラスに関するクラスタの全投稿に占める投稿の割合（0から1）。

gainers[].name

string 必須

人間が読める名前。

gainers[].previous_share

number (double) 必須

比較ウィンドウにおけるクラスタの全投稿に占めるこの資産の投稿の割合（0から1）。

gainers[].share_change_bps

integer 必須

current_shareから比較ウィンドウのシェアを引いた値（ベーシスポイント）：100は1パーセントポイント。負の値はシェアが低下したことを意味します。

gainers[].symbol

string 必須

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

hours

integer 必須

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

losers

array<object> 必須

クラスタの投稿シェアが最も下落した資産（下落幅の大きい順）。シェアが下落した資産のみがリストされます。

losers[].asset_class

string 必須

指定可能な値

equitycommodityindexcrypto

losers[].asset_id

string 必須

losers[].current_share

number (double) 必須

現在のウィンドウで選択した資産クラスに関するクラスタの全投稿に占める投稿の割合（0から1）。

losers[].name

string 必須

人間が読める名前。

losers[].previous_share

number (double) 必須

比較ウィンドウにおけるクラスタの全投稿に占めるこの資産の投稿の割合（0から1）。

losers[].share_change_bps

integer 必須

current_shareから比較ウィンドウのシェアを引いた値（ベーシスポイント）：100は1パーセントポイント。負の値はシェアが低下したことを意味します。

losers[].symbol

string 必須

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

topic_changes

array<object> 必須

現在のウィンドウにおける各トピックのシェアと前回からの変化（equity、commodity、index、crypto、people、eventsの順）。

topic_changes[].current_share

number (double) 必須

現在のウィンドウにおけるクラスタの投稿に占めるこのトピックのシェア（0から1）。

topic_changes[].share_change_bps

integer 必須

前のウィンドウからのシェアの変化（ベーシスポイント、100は1パーセントポイント）。

topic_changes[].topic

string 必須

equity、commodity、index、crypto、people（人物とそのアカウント）、またはevents（場所、テーマ、イベント）。

指定可能な値

equitycommodityindexcryptopeopleevents

topic_series

array<object> 必須

UTCの完全日ごとのクラスタの投稿に占める各トピックのシェア（古い順）。

topic_series[].timestamp

string (date-time) 必須

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

topic_series[].topics

array<object> 必須

その日のクラスタの投稿に占める各トピックのシェア（topic_changesの順）。クラスタがその日に投稿した場合、シェアの合計は1になります。

topic_series[].topics[].topic

string 必須

equity、commodity、index、crypto、people（人物とそのアカウント）、またはevents（場所、テーマ、イベント）。

指定可能な値

equitycommodityindexcryptopeopleevents

topic_series[].topics[].topic_share

number (double) 必須

その日のクラスタの投稿に占めるこのトピックのシェア（0から1）。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}