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

REST API
クラスター

クラスターのスタンス

GET /clusters/stances

GetClusterStances

最も議論されている資産に対するあるクラスタのスタンスを市場のものと並べて示します（−1はすべて弱気、+1はすべて強気）。contrarian_shareは市場と逆方向に傾く頻度で、他のクラスタの平均と比較できます。

パラメータのルール:

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

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

days integer QUERY

スタンスを測定する完全なUTC日数。最新の完全日から遡って数えます：7、30、または90。無料プランは90日まで遡れます。それより前を指定すると403を返します。

指定可能な値

73090

Default:30

limit integer QUERY

返される資産の最大数。

Default:30

cURL の例

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

assets

array<object> 必須

クラスタで最も議論されている対象資産（クラスタの投稿が3件以上、市場の投稿が20件以上）、最大limit件まで。

assets[].asset_class

string 必須

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

指定可能な値

equitycommodityindexcrypto

assets[].asset_id

string 必須

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

assets[].cluster_posts

integer (int64) 必須

ウィンドウ中のこの資産に関するクラスタの投稿。

assets[].cluster_stance

number (double) 必須

ウィンドウ中のこの資産に対するクラスタのネットスタンス：(強気 − 弱気) / (強気 + 弱気) の投稿、−1（すべて弱気）から+1（すべて強気）まで。

assets[].market_stance

number (double) 必須

同じウィンドウにおける同じ資産に対する市場のネットスタンス。同じ−1から+1のスケールで、ボットを除くすべての投稿者によるもの。

assets[].name

string 必須

人間が読める名前。

assets[].symbol

string 必須

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

cluster_id

string 必須

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

contrarian_share

number (double) 必須

クラスタと市場が逆方向に傾いている対象資産の割合（いずれも中立から0.1以上）。資産が5件未満の場合はnull。

days

integer 必須

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

peer_average_contrarian_share

number (double) 必須

他のクラスタで平均したcontrarian_share。値を持つクラスタがない場合はnull。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}