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

クラスターのハイプサイクル

GET /clusters/hype-cycles
GetClusterHypeCycles

ハイプサイクルにおいて、あるクラスターが市場と比べてどれだけ早く動き出すか。curve はピークの7日前から7日後までの各サイドの投稿の累積シェアで、線が左にあるほど早いことを示す。lead_days はそのクラスターのリード（正なら早い）、clusters は全クラスターのリードを順位付けしたもの。

パラメータのルール:

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

ウォレット支払いは https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/hype-cycles で利用できます。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/hype-cycles' \
  --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

asset_classes
array<string> 必須

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

cluster_id
string 必須

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

clusters
array<object> 必須

リードを持つ全クラスター（5サイクル以上）を、早い順に並べたもの。リクエストしたクラスターも含まれます。
clusters[].cluster_id
string 必須

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

clusters[].cycles_joined
integer 必須

市場のピーク時刻から24時間以内にそのクラスターが投稿した、完了済みのハイプサイクル。

clusters[].lead_days
number (double) 必須

そのクラスターのリード（日数）。トップレベルの lead_days として計算されます。正なら早いことを示します。

clusters[].lead_high_days
number (double) 必須

lead_days の想定範囲の上限。

clusters[].lead_low_days
number (double) 必須

lead_days の想定範囲の下限。

curve
array<object> 必須

平均的な累積の盛り上がり。day_offset が −7 から +7 まで1日1ポイント。完了したサイクルがない場合は空になります。
curve[].cluster_cumulative_pct
number (double) 必須

ピーク前後15日間におけるそのクラスターの投稿のうち、この日までに行われた割合。サイクル間で平均されます。day_offset 7 で 100 になります。

curve[].day_offset
integer 必須

市場ピークからの日数。ピーク前は負、ピーク当日は 0、ピーク後は正。

curve[].market_cumulative_pct
number (double) 必須

同じサイクルにおける市場についての同様の値。

cycles_joined
integer 必須

そのクラスターが参加した完了済みのハイプサイクル。ピークから7日以内に3件以上の投稿があったもの。

days
integer 必須

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

lead_days
number (double) 必須

市場のピーク時刻から24時間以内にそのクラスターの投稿が他のすべてよりどれだけ先行するか（日数）。正なら早いことを示します。20サイクル未満の場合は null。

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "clusters": [
    {
      "cluster_id": "wallstreetbets",
      "cycles_joined": 171,
      "lead_days": 0.0542,
      "lead_high_days": 0.0708,
      "lead_low_days": 0.0417
    },
    {
      "cluster_id": "smart_money",
      "cycles_joined": 471,
      "lead_days": 0.0125,
      "lead_high_days": 0.0292,
      "lead_low_days": -0.0083
    },
    {
      "cluster_id": "exchanges",
      "cycles_joined": 466,
      "lead_days": -0.0667,
      "lead_high_days": -0.0542,
      "lead_low_days": -0.0792
    }
  ],
  "curve": [
    {
      "cluster_cumulative_pct": 46.8,
      "day_offset": -1,
      "market_cumulative_pct": 38.2
    },
    {
      "cluster_cumulative_pct": 63.5,
      "day_offset": 0,
      "market_cumulative_pct": 57.9
    },
    {
      "cluster_cumulative_pct": 73.1,
      "day_offset": 1,
      "market_cumulative_pct": 69.4
    }
  ],
  "cycles_joined": 27,
  "days": 90,
  "lead_days": 0.0125
}