全部文档 Nebula 文档 所有端点 交互式文档 Markdown OpenAPI JSON
  1. REST API
  2. 聚类

聚类立场

GET /clusters/stances
GetClusterStances

某个聚类对其讨论最多的资产所持立场，与市场立场并列，从 −1（全部看跌）到 +1（全部看涨）。contrarian_share 是它与市场倾向相反的频率，并附其他聚类的平均值以供比较。

参数规则：

  • 发送 cluster_id。
  • cluster_id 只指定一个集群；若要比较多个集群，请对每个集群分别调用，或使用 /clusters 一次性获取所有集群。
  • 发帖社区（wallstreetbets、reddit）仅覆盖股票：使用其中之一时，asset_class 必须包含 equity。

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/stances 使用。无需 Nebula 账户或 API key；签名前请先查看支付报价。x402 支付指南。

参数

cluster_id string QUERY 必填

要分析的集群，格式与 /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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
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 必填

规范的公开资产标识符：股票、商品和指数的股票代码或市场符号，以及加密货币的 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 必填

显示的股票代码或市场符号。

cluster_id
string 必填

所分析的集群，以其规范 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
}