全部文档 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 key；签名前请先查看支付报价。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 Credits 已用尽；响应中包含续期时间和已购买的 credit 余额
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 必填

天数、占比（0 到 1）或计数；每个特征固定。

允许的值
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"
    }
  ]
}