叢集概況
/clusters/profile
單一 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,格式與 /clusters 傳回的一致,例如 smart_money 或 wallstreetbets。可取自 /sentiment 的 clusters 參數中的任何 id。
Example:smart_money
要分析的市場:可為 equity、commodity、index 和 crypto 任一種,以逗號分隔。預設為全部四種。可傳送多個並以逗號分隔。
Default:equity,commodity,index,crypto
要分析的完整 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'
回應
媒體類型 application/json
active_clusters
視窗內活躍的叢集:群體特徵即在此範圍內排名。
asset_classes
所分析的市場,依 equity、commodity、index、crypto 的順序:所要求的 asset_class 值,若省略 asset_class 則為全部四者。
cluster_id
所分析的 cluster,以其標準 cluster_id 表示。
days
視窗長度,以完整 UTC 日為單位,結束於最近一個完整日。
hype_cycles
視窗內的市場熱潮:單日貼文數達到 50 篇以上,且至少為其單日中位數 3 倍的資產。
traits
array<object>
每個特徵一筆項目,依序為 earliness、contrarian、hype_fade、conviction、focus、breadth、bullishness、discovery、turnover、coverage。
traits
每個特徵一筆項目,依序為 earliness、contrarian、hype_fade、conviction、focus、breadth、bullishness、discovery、turnover、coverage。
traits[].peer_values
其他所有叢集在此特徵上的值,由小到大排列。
traits[].percentile
在有值的叢集中,從 0(最低)到 1(最高)。值為 null 時為 null。
traits[].rank
1 為最高值;同值的叢集共用較佳的排名。值為 null 時為 null。
traits[].trait
所衡量的特徵;各項特徵的定義請見操作說明。
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
days、share(0 到 1)或 count;每個 trait 固定不變。
dayssharecount
traits[].value
此叢集在此特徵上的值,以 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
}
]
}