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

REST API
クラスター

クラスターの重複

GET /clusters/overlap

GetClusterOverlap

どのクラスターがこのクラスターと同じ資産を監視しているか、またそれらが一致しているか。overlap_share はピアが共有する上位50資産の割合、direction_agreement_share は同じ方向に傾く頻度、stance_gap はこのクラスターの方が強気な場合に正になります。

パラメータのルール:

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

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

cURL の例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/overlap' \
  --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 で示されます。

days

integer 必須

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

peers

array<object> 必須

他のすべてのアクティブなクラスター。重なりの大きい順。

peers[].agreeing_asset_count

integer 必須

両方のクラスターが市場に対して同じ方向に傾いている比較対象の資産。

peers[].cluster_id

string 必須

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

peers[].compared_asset_count

integer 必須

重なりの全体を通じて、両方のクラスターが市場のスタンスから少なくとも 0.05 傾いている共有資産。

peers[].direction_agreement_share

number (double) 必須

両方のクラスターが市場のスタンスから少なくとも 0.05 傾いている共有資産のうち、同じ方向に傾いているものの割合: agreeing_asset_count ÷ compared_asset_count。資産が3未満の場合は null。

peers[].overlap_share

number (double) 必須

このクラスターのフォーカスセットのうち、ピアのセットにも含まれるものの割合（0〜1）。

peers[].shared_assets

array<object> 必須

両方のフォーカスセットに含まれる最大5つの資産。このクラスターの注目度順。

peers[].shared_assets[].asset_class

string 必須

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

指定可能な値

equitycommodityindexcrypto

peers[].shared_assets[].asset_id

string 必須

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

peers[].shared_assets[].cluster_stance

number (double) 必須

このクラスターのその資産に対するネットスタンス（−1〜+1）。強気または弱気の投稿が3件未満の場合は null。

peers[].shared_assets[].market_stance

number (double) 必須

その資産に対する市場のネットスタンス（−1〜+1）。両方の傾きを測定する基準となります。強気または弱気の投稿が3件未満の場合は null。

peers[].shared_assets[].name

string 必須

人間が読める名前。

peers[].shared_assets[].peer_stance

number (double) 必須

その資産に対するピアのネットスタンス（−1〜+1）。強気または弱気の投稿が3件未満の場合は null。

peers[].shared_assets[].symbol

string 必須

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

peers[].stance_gap

number (double) 必須

このクラスターのスタンスからピアのスタンスを引いた値。両方がスタンスを持つ共有資産で平均されます（−2〜+2）。正ならこのクラスターの方が強気です。資産が3未満の場合は null。

top_asset_count

integer 必須

各クラスターのフォーカスセットのサイズ。最も議論されている資産を、この数まで含みます。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}