すべてのドキュメント Nebula ドキュメント すべてのエンドポイント インタラクティブドキュメント Markdown OpenAPI JSON
  1. REST API
  2. クラスター

クラスタープロファイル

GET /clusters/profile
GetClusterProfile

1つのクラスターの行動特性。それぞれ他のすべてのクラスターと比較して順位付けされます（rank 1 が最高）。

  • earliness（日数）: ハイプサイクルのピーク前後にどれだけ早く投稿するか。正なら早いことを示します。
  • contrarian（シェア）: 市場と逆方向に傾いている資産。
  • hype_fade（日数）: 正なら、ハイプが高まるにつれて強気度が下がることを示します。
  • conviction（日数）: ある資産に対して同じ見方をどれだけ長く保持するか。
  • focus（シェア）: 上位5資産への投稿。
  • breadth（件数）：言及している資産の数。
  • bullishness（割合）：強気と弱気の投稿に占める強気の割合。
  • discovery（割合）：市場のトップ100圏外の資産に関する投稿。
  • turnover（割合）：上位10資産が週ごとにどれだけ変化するか。
  • coverage（割合）：参加したハイプサイクル。

ハイプサイクルとは、ある資産の投稿が通常の3倍以上に急増した日のことです。UTCの完全な日のみを対象とします。

パラメータのルール:

  • cluster_id を送信します。
  • cluster_id は1つのクラスターを指定します。複数を比較するにはクラスターごとに呼び出すか、/clusters を使って全クラスターを一度に取得してください。
  • 投稿コミュニティ（wallstreetbets、reddit）は株式のみを対象とします。いずれかを指定する場合、asset_class には equity を含める必要があります。

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/profile で利用できます。Nebula アカウントや API キーは不要です。署名する前に支払いオファーを確認してください。x402 支払いガイド。

パラメータ

cluster_id string QUERY 必須

分析するクラスターを /clusters が返す形式で指定します。例えば smart_money や wallstreetbets です。/sentiment の clusters パラメータで得られる任意の id を使用できます。

Example:smart_money

asset_class array<string> QUERY

分析する市場。equity、commodity、index、crypto のいずれかをカンマ区切りで指定します。デフォルトは4つすべてです。複数指定する場合はカンマで区切って送信してください。

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 クレジットを使い切りました。レスポンスには更新時期と購入済みクレジット残高が含まれます
403 アクセス拒否
404 見つかりません
405 メソッドが許可されていません。Allow ヘッダーにサポートされているメソッドが記載されています。
429 リクエストが多すぎます
500 内部サーバーエラー
503 サービス利用不可

メディアタイプ application/json

active_clusters
integer 必須

ウィンドウ内でアクティブなクラスター：母集団特性はこの中でランク付けされます。

asset_classes
array<string> 必須

分析された市場。equity、commodity、index、crypto の順：要求された asset_class の値、または asset_class を省略した場合は4つすべて。

cluster_id
string 必須

分析されたクラスター。正規の cluster_id で示されます。

days
integer 必須

完全なUTC日単位のウィンドウ長。最新の完全日で終了します。

hype_cycles
integer 必須

ウィンドウ内の市場ハイプサイクル：1日の投稿数が50以上に達し、かつ中央値の日の3倍以上になった資産。

traits
array<object> 必須

特性ごとに1エントリ。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) 必須

この特性に対するクラスタの値（単位付き）。クラスタのデータが不足している場合は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
    }
  ]
}