所有文件 Nebula 文件 所有端點 互動式文件 Markdown OpenAPI JSON
  1. REST API
  2. 叢集

叢集重疊

GET /clusters/overlap
GetClusterOverlap

哪些 cluster 關注與此 cluster 相同的資產，以及它們的看法是否一致。overlap_share 是某個同儕與其前 50 大資產的重疊比例；direction_agreement_share 是它們看法一致的頻率；stance_gap 為正值時，代表此 cluster 較看多。

參數規則：

  • 傳送 cluster_id。
  • cluster_id 一次只指定一個 cluster；若要比較多個 cluster，請逐一呼叫，或改用 /clusters 一次取得所有 cluster。
  • 貼文社群（wallstreetbets、reddit）僅涵蓋股票：使用其中一個時，asset_class 必須包含 equity。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/overlap 付款。不需要 Nebula 帳號或 API 金鑰；簽署前請先確認付款條件。x402 付款指南。

參數

cluster_id string QUERY 必填

要分析的 cluster，格式與 /clusters 傳回的一致，例如 smart_money 或 wallstreetbets。可取自 /sentiment 的 clusters 參數中的任何 id。

Example:smart_money

asset_class array<string> QUERY

要分析的市場：可為 equity、commodity、index 和 crypto 任一種，以逗號分隔。預設為全部四種。可傳送多個並以逗號分隔。

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 則為全部四者。

cluster_id
string 必填

所分析的 cluster，以其標準 cluster_id 表示。

days
integer 必填

視窗長度，以完整 UTC 日為單位，結束於最近一個完整日。

peers
array<object> 必填

其他所有活躍 cluster，依重疊程度由高到低排序。
peers[].agreeing_asset_count
integer 必填

兩個 cluster 相對於市場看法一致的比較資產。

peers[].cluster_id
string 必填

標準作者叢集識別碼。

peers[].compared_asset_count
integer 必填

在整體重疊範圍內，兩個 cluster 相對於市場立場的偏離程度皆至少 0.05 的共同資產。

peers[].direction_agreement_share
number (double) 必填

在兩個 cluster 相對於市場立場的偏離程度皆至少 0.05 的共同資產中，看法一致者所占的比例：agreeing_asset_count ÷ compared_asset_count。資產數未滿 3 時為 null。

peers[].overlap_share
number (double) 必填

此 cluster 的關注集合中，也出現在同儕關注集合的比例，從 0 到 1。

peers[].shared_assets
array<object> 必填

同時出現在兩個關注集合中的最多 5 項資產，依此 cluster 的關注程度排序。
peers[].shared_assets[].asset_class
string 必填

資產的類別：equity（股票與 ETF）、commodity、index 或 crypto。請在每個以資產為範圍的要求中，與 asset_id 一併送出。

允許的值
equitycommodityindexcrypto
peers[].shared_assets[].asset_id
string 必填

標準的公開資產識別碼：股票、商品與指數為 ticker 或市場代號，crypto 則為 CoinGecko slug（若無 slug，則為數字 id）。

peers[].shared_assets[].cluster_stance
number (double) 必填

此 cluster 對該資產的淨立場，從 −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 必填

顯示用的 ticker 或市場代號。

peers[].stance_gap
number (double) 必填

此 cluster 的立場減去同儕的立場，並對雙方皆有立場的共同資產取平均，從 −2 到 +2。正值代表此 cluster 較看多。資產數未滿 3 時為 null。

top_asset_count
integer 必填

各 cluster 關注集合的大小：其討論最多的資產，最多達此數量。

{
  "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
}