所有文件 Nebula 文件所有端點互動式文件 Markdown OpenAPI JSON

REST API
叢集

叢集立場

GET /clusters/stances

GetClusterStances

某個叢集對其最熱門討論資產的立場，並與市場的立場並列，從 −1（全看空）到 +1（全看多）。contrarian_share 是它與市場立場相反的程度，並附上其他叢集的平均值以供比較。

參數規則：

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

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/stances 付款。不需要 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

limit integer QUERY

傳回的資產數量上限。

Default:30

cURL 範例

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

assets

array<object> 必填

該叢集最熱門討論的合格資產（該叢集至少 3 篇貼文、市場至少 20 篇貼文），最多 limit 個。

assets[].asset_class

string 必填

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

允許的值

equitycommodityindexcrypto

assets[].asset_id

string 必填

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

assets[].cluster_posts

integer (int64) 必填

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

assets[].cluster_stance

number (double) 必填

該叢集在該視窗內對該資產的淨立場：（看多 − 看空）/（看多 + 看空）貼文，從 −1（全看空）到 +1（全看多）。

assets[].market_stance

number (double) 必填

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

assets[].name

string 必填

人類可讀的名稱。

assets[].symbol

string 必填

顯示用的 ticker 或市場代號。

cluster_id

string 必填

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

contrarian_share

number (double) 必填

該叢集與市場立場相反（雙方皆至少偏離中性 0.1）的合格資產占比。少於 5 個資產時為 null。

days

integer 必填

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

peer_average_contrarian_share

number (double) 必填

其他叢集的 contrarian_share 平均值；若無任何叢集有此值則為 null。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}