叢集概況

GET /clusters/profile
GetClusterProfile

單一 cluster 的行為特徵,每項皆與其他所有 cluster 相比排名(rank 1 為最高):

  • earliness(days):它在 hype cycle 高峰前後多早發文;正值代表較早。
  • contrarian(share):它與市場立場相反的資產。
  • hype_fade(days):正值代表隨著 hype 升溫,它變得較不看多。
  • conviction(days):它對某項資產維持相同看法的時間長度。
  • focus(share):針對其前 5 大資產的貼文。
  • breadth(計數):其討論的資產數量。
  • bullishness(占比):其看多貼文在看多與看空貼文中的占比。
  • discovery(占比):討論市場前 100 名以外資產的貼文占比。
  • turnover(占比):其前 10 大資產每週的變動幅度。
  • coverage(占比):其參與過的熱潮週期。

熱潮週期是指某資產的貼文量在一天內暴增至正常量至少 3 倍。僅計完整的 UTC 日。

參數規則:

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

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/profile 付款。不需要 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 日數,從最近一個完整日往回計算:30 或 90。視窗越長看到的熱潮越多,因此週期特徵越穩定。免費方案可回溯 90 天;超過則傳回 403。

允許的值
3090

Default:90

cURL 範例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/profile' \
  --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

active_clusters
integer 必填

視窗內活躍的叢集:群體特徵即在此範圍內排名。

asset_classes
array<string> 必填

所分析的市場,依 equity、commodity、index、crypto 的順序:所要求的 asset_class 值,若省略 asset_class 則為全部四者。

cluster_id
string 必填

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

days
integer 必填

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

hype_cycles
integer 必填

視窗內的市場熱潮:單日貼文數達到 50 篇以上,且至少為其單日中位數 3 倍的資產。

traits
array<object> 必填

每個特徵一筆項目,依序為 earliness、contrarian、hype_fade、conviction、focus、breadth、bullishness、discovery、turnover、coverage。

traits[].peer_values
array<number (double)> 必填

其他所有叢集在此特徵上的值,由小到大排列。

traits[].percentile
number (double) 必填

在有值的叢集中,從 0(最低)到 1(最高)。值為 null 時為 null。

traits[].rank
integer 必填

1 為最高值;同值的叢集共用較佳的排名。值為 null 時為 null。

traits[].trait
string 必填

所衡量的特徵;各項特徵的定義請見操作說明。

允許的值
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string 必填

days、share(0 到 1)或 count;每個 trait 固定不變。

允許的值
dayssharecount
traits[].value
number (double) 必填

此叢集在此特徵上的值,以 unit 為單位;資料不足時為 null。

{
  "active_clusters": 34,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "peer_values": [
        -1.8,
        -0.64,
        0.12,
        0.87,
        2.05
      ],
      "percentile": 0.9394,
      "rank": 3,
      "trait": "earliness",
      "unit": "days",
      "value": 1.42
    },
    {
      "peer_values": [
        0.041,
        0.083,
        0.112,
        0.204,
        0.267
      ],
      "percentile": 0.7576,
      "rank": 9,
      "trait": "contrarian",
      "unit": "share",
      "value": 0.1875
    },
    {
      "peer_values": [
        -1.1,
        -0.3,
        0.2,
        0.9,
        1.4
      ],
      "percentile": 0.8182,
      "rank": 7,
      "trait": "hype_fade",
      "unit": "days",
      "value": 0.6
    },
    {
      "peer_values": [
        1.4,
        1.9,
        2.2,
        2.8,
        3.6
      ],
      "percentile": 0.6667,
      "rank": 12,
      "trait": "conviction",
      "unit": "days",
      "value": 2.35
    },
    {
      "peer_values": [
        0.18,
        0.24,
        0.35,
        0.47,
        0.72
      ],
      "percentile": 0.4242,
      "rank": 20,
      "trait": "focus",
      "unit": "share",
      "value": 0.31
    },
    {
      "peer_values": [
        41,
        96,
        188,
        405,
        1270
      ],
      "percentile": 0.8485,
      "rank": 6,
      "trait": "breadth",
      "unit": "count",
      "value": 312
    },
    {
      "peer_values": [
        0.52,
        0.64,
        0.71,
        0.78,
        0.86
      ],
      "percentile": 0.6061,
      "rank": 14,
      "trait": "bullishness",
      "unit": "share",
      "value": 0.7412
    },
    {
      "peer_values": [
        0.09,
        0.17,
        0.26,
        0.38,
        0.61
      ],
      "percentile": 0.5152,
      "rank": 17,
      "trait": "discovery",
      "unit": "share",
      "value": 0.2837
    },
    {
      "peer_values": [
        0.18,
        0.27,
        0.36,
        0.44,
        0.58
      ],
      "percentile": 0.3939,
      "rank": 21,
      "trait": "turnover",
      "unit": "share",
      "value": 0.3455
    },
    {
      "peer_values": [
        0.05,
        0.22,
        0.41,
        0.63,
        0.88
      ],
      "percentile": 0.7879,
      "rank": 8,
      "trait": "coverage",
      "unit": "share",
      "value": 0.6585
    }
  ]
}