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

具爭議性資產

GET /clusters/comparison/divisive-assets
GetDivisiveAssets

各叢集意見分歧最大的熱門討論資產。minority_share 是明確偏多或偏空的叢集中，較小一方所占的比例，因此 0.5 代表勢均力敵。這衡量的是討論的分裂程度，而非即將到來的走勢。

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

參數

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

limit integer QUERY

傳回的資產數量上限。

Default:10

cURL 範例

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/divisive-assets' \
  --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 則為全部四者。

assets
array<object> 必填

意見分歧的資產，依分裂程度由最平均到最不平均排序，最多至 limit。
assets[].asset_class
string 必填

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

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

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

assets[].bearish_cluster_count
integer 必填

對該資產偏空程度達 0.1 以上的叢集。

assets[].bullish_cluster_count
integer 必填

對該資產偏多程度達 0.1 以上的叢集。

assets[].cluster_stances
array<object> 必填

所有對該資產有立場的叢集（看漲或看跌貼文達 8 篇以上），依偏空程度由高到低排序。
assets[].cluster_stances[].cluster_id
string 必填

標準作者叢集識別碼。

assets[].cluster_stances[].posts
integer (int64) 必填

該叢集在視窗內對該資產的貼文。

assets[].cluster_stances[].stance
number (double) 必填

該叢集對該資產的淨立場：(看漲 − 看跌) ÷ (看漲 + 看跌) 貼文數，範圍從 −1 到 +1。

assets[].market_stance
number (double) 必填

整體市場在同一視窗內對同一資產的淨立場，採用相同的 −1 到 +1 尺度，涵蓋除了機器人以外的所有作者。

assets[].minority_share
number (double) 必填

明確偏多或偏空（任一方達 0.1 以上）的叢集中，較小一方所占的比例，從 0（全數偏向同一方）到 0.5（勢均力敵）。資產依此排序。

assets[].name
string 必填

人類可讀的名稱。

assets[].stance_iqr
number (double) 必填

各叢集立場的四分位距，從 0 到 2：中間半數叢集的立場差距有多大。用於在 minority_share 相同時決定排序。

assets[].symbol
string 必填

顯示用的 ticker 或市場代號。

days
integer 必填

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "WMT",
      "bearish_cluster_count": 14,
      "bullish_cluster_count": 5,
      "cluster_stances": [
        {
          "cluster_id": "policy_political",
          "posts": 64,
          "stance": -0.58
        },
        {
          "cluster_id": "media",
          "posts": 311,
          "stance": -0.21
        },
        {
          "cluster_id": "automated_ai",
          "posts": 28,
          "stance": 0.75
        }
      ],
      "market_stance": -0.17,
      "minority_share": 0.2632,
      "name": "Walmart Inc.",
      "stance_iqr": 0.6125,
      "symbol": "WMT"
    }
  ],
  "days": 30
}