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

叢集特徵比較

GET /clusters/comparison/traits
CompareClusterTraits

所有叢集的每個 /clusters/profile 特徵，依數值由高到低排序，用來看出哪些群體在各項特徵上領先或落後。

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

參數

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

days
integer 必填

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

hype_cycles
integer 必填

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

traits
array<object> 必填

每個特徵一筆項目，依序為 earliness、contrarian、hype_fade、conviction、focus、breadth、bullishness、discovery、turnover、coverage。
traits[].clusters
array<object> 必填

所有具有該特徵值的叢集，依數值由高到低排序。
traits[].clusters[].cluster_id
string 必填

標準作者叢集識別碼。

traits[].clusters[].value
number (double) 必填

該叢集在此特徵上的數值，單位為 unit。

traits[].trait
string 必填

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

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

days、share（0 到 1）或 count；每個 trait 固定不變。

允許的值
dayssharecount 
{
  "active_clusters": 35,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "clusters": [
        {
          "cluster_id": "early_movers",
          "value": 0.0875
        },
        {
          "cluster_id": "smart_money",
          "value": 0.0111
        },
        {
          "cluster_id": "late_movers",
          "value": -0.0917
        }
      ],
      "trait": "earliness",
      "unit": "days"
    },
    {
      "clusters": [
        {
          "cluster_id": "dao_funds",
          "value": 0.9912
        },
        {
          "cluster_id": "smart_money",
          "value": 0.8431
        },
        {
          "cluster_id": "doomers",
          "value": 0.3015
        }
      ],
      "trait": "bullishness",
      "unit": "share"
    }
  ]
}