聚类画像

GET /clusters/profile
GetClusterProfile

某个集群的行为特征,每项均相对于所有其他集群排名(rank 1 为最高):

  • earliness(天):它在热度周期峰值前后发帖的提前程度;正值表示提前。
  • contrarian(占比):它与市场倾向相反的资产。
  • hype_fade(天):正值表示随着热度积累,它变得不那么看涨。
  • conviction(天):它对某个资产保持相同观点的时间。
  • focus(占比):关于其前 5 个资产的帖子。
  • breadth(数量):它讨论的资产数量。
  • bullishness(占比):其看涨帖子在看涨与看跌帖子中的占比。
  • discovery(占比):讨论市场前 100 名之外资产的帖子占比。
  • turnover(占比):其前 10 大资产逐周变化的幅度。
  • coverage(占比):它参与过的炒作周期。

炒作周期是指某资产的帖子量激增至正常水平至少 3 倍的一天。仅统计完整的 UTC 日。

参数规则:

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

钱包支付可通过 https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/profile 使用。无需 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 日数,从最近一个完整日往前计: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'

响应

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,则为全部四个。

cluster_id
string 必填

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

days
integer 必填

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

hype_cycles
integer 必填

窗口内的市场炒作周期:帖子数在单日达到 50 条或以上,且至少为其单日中位数的 3 倍的资产。

traits
array<object> 必填

每个特征一个条目,顺序为 earliness、contrarian、hype_fade、conviction、focus、breadth、bullishness、discovery、turnover、coverage。

traits[].peer_values
array<number (double)> 必填

其他每个聚类在该特征上的取值,按升序排列。

traits[].percentile
number (double) 必填

在有取值的聚类中,从 0(最低)到 1(最高)。取值为 null 时为 null。

traits[].rank
integer 必填

1 为最高值;取值相同的聚类共享较优排名。取值为 null 时为 null。

traits[].trait
string 必填

所衡量的特征;各特征的定义见操作说明。

允许的值
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string 必填

天数、占比(0 到 1)或计数;每个特征固定。

允许的值
dayssharecount
traits[].value
number (double) 必填

该聚类在此特征上的取值,单位为 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
    }
  ]
}