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

聚类重叠

GET /clusters/overlap
GetClusterOverlap

哪些集群关注与该集群相同的资产，以及它们是否一致。overlap_share 是同类集群与其前 50 个资产的重合比例；direction_agreement_share 是它们倾向相同的频率；stance_gap 为正表示该集群更看涨。

参数规则：

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

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/overlap 使用。无需 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

cURL 示例

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/overlap' \
  --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，则为全部四个。

cluster_id
string 必填

所分析的集群，以其规范 cluster_id 表示。

days
integer 必填

窗口长度，以完整 UTC 日计，截止到最近一个完整日。

peers
array<object> 必填

所有其他活跃集群，按重合度从高到低排列。
peers[].agreeing_asset_count
integer 必填

两个集群相对于市场倾向相同的被比较资产。

peers[].cluster_id
string 必填

规范的作者集群标识符。

peers[].compared_asset_count
integer 必填

在整个重合范围内，两个集群相对于市场立场偏离至少 0.05 的共有资产。

peers[].direction_agreement_share
number (double) 必填

在两个集群相对于市场立场偏离至少 0.05 的共有资产中，它们倾向相同的比例：agreeing_asset_count ÷ compared_asset_count。少于 3 个资产时为 null。

peers[].overlap_share
number (double) 必填

该集群关注集合中同时属于同类集群的比例，从 0 到 1。

peers[].shared_assets
array<object> 必填

两个关注集合中共有的最多 5 个资产，按该集群的关注度排序。
peers[].shared_assets[].asset_class
string 必填

资产的类别：equity（股票和 ETF）、commodity、index 或 crypto。在每个资产范围的请求中都要与 asset_id 一同发送。

允许的值
equitycommodityindexcrypto
peers[].shared_assets[].asset_id
string 必填

规范的公开资产标识符：股票、商品和指数的股票代码或市场符号，以及加密货币的 CoinGecko slug（若无 slug，则为数字 id）。

peers[].shared_assets[].cluster_stance
number (double) 必填

该集群对该资产的净立场，从 −1 到 +1。看涨或看跌帖子少于 3 条时为 null。

peers[].shared_assets[].market_stance
number (double) 必填

市场对该资产的净立场，从 −1 到 +1：作为衡量两种倾向的基准。看涨或看跌帖子少于 3 条时为 null。

peers[].shared_assets[].name
string 必填

人类可读的名称。

peers[].shared_assets[].peer_stance
number (double) 必填

同类集群对该资产的净立场，从 −1 到 +1。看涨或看跌帖子少于 3 条时为 null。

peers[].shared_assets[].symbol
string 必填

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

peers[].stance_gap
number (double) 必填

该集群的立场减去同类集群的立场，在双方均有立场的共有资产上取平均，从 −2 到 +2。正值表示该集群更看涨。少于 3 个资产时为 null。

top_asset_count
integer 必填

每个集群关注集合的大小：即其讨论最多的资产，最多为此数量。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}