전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. 클러스터

하이프 사이클 도달

GET /clusters/comparison/hype-cycles
CompareHypeCycles

윈도우의 가장 큰 하이프 사이클과 각 사이클에 클러스터가 도착한 순서를 시장의 피크 시간을 기준으로 나타내며, 피크 전후의 시장 시간당 게시물도 함께 제공합니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/hype-cycles에서 월렛 결제를 사용할 수 있습니다. Nebula 계정이나 API 키가 필요하지 않으며, 서명하기 전에 결제 제안을 확인하세요. x402 결제 가이드.

파라미터

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

limit integer QUERY

반환되는 최대 하이프 사이클 수: 피크 일자의 게시물 기준으로 가장 큰 사이클입니다.

Default:40

cURL 예제

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/hype-cycles' \
  --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를 생략한 경우에는 네 가지 모두입니다.

cycles
array<object> 필수

윈도우의 가장 큰 하이프 사이클로, 가장 최근 피크 순서이며, limit까지 반환됩니다.
cycles[].arrivals
array<object> 필수

피크 시간 전후 48시간 동안 게시물이 3개 이상인 모든 클러스터로, 가장 이른 순서입니다.
cycles[].arrivals[].cluster_id
string 필수

정규 작성자 클러스터 식별자입니다.

cycles[].arrivals[].offset_hours
number (double) 필수

시장의 피크 시간에서 피크 전후 48시간 동안 클러스터 게시물의 게시물 가중 평균 시간까지의 시간입니다. 음수는 피크 이전을 의미합니다.

cycles[].arrivals[].posts
integer (int64) 필수

피크 시간 전후 48시간 동안 해당 자산에 대한 클러스터의 게시물입니다.

cycles[].asset_class
string 필수

자산의 클래스입니다: equity(주식 및 ETF), commodity, index, crypto 중 하나입니다. asset 범위의 모든 요청에 asset_id와 함께 보내세요.

허용 값
equitycommodityindexcrypto
cycles[].asset_id
string 필수

공개 자산의 정규 식별자입니다: 주식, 상품, 지수의 경우 티커 또는 시장 심볼이고, crypto의 경우 CoinGecko 슬러그(슬러그가 없으면 숫자 id)입니다.

cycles[].name
string 필수

사람이 읽을 수 있는 이름입니다.

cycles[].peak_day_posts
integer (int64) 필수

피크 일자의 해당 자산에 대한 시장의 게시물로, 봇은 제외됩니다.

cycles[].peak_timestamp
string (date-time) 필수

피크 일자의 시장 최대 활동 시간의 UTC 시작 시각입니다.

cycles[].series
array<object> 필수

피크 시간 24시간 전부터 23시간 후까지, 해당 자산에 대한 시장의 시간당 게시물: 48개 관측치입니다.
cycles[].series[].posts
integer (int32) 필수

해당 시간 동안 해당 자산에 대한 시장의 게시물로, 봇은 제외됩니다.

cycles[].series[].timestamp
string (date-time) 필수

해당 시간의 UTC 시작 시각입니다.

cycles[].symbol
string 필수

표시용 티커 또는 시장 심볼입니다.

days
integer 필수

가장 최근의 완전한 일자에서 끝나는, 완전한 UTC 일자 단위의 윈도우 길이입니다.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cycles": [
    {
      "arrivals": [
        {
          "cluster_id": "smart_money",
          "offset_hours": -3.2,
          "posts": 18
        },
        {
          "cluster_id": "team_leaders",
          "offset_hours": -2.1,
          "posts": 9
        },
        {
          "cluster_id": "media",
          "offset_hours": 1.4,
          "posts": 57
        }
      ],
      "asset_class": "equity",
      "asset_id": "ORCL",
      "name": "Oracle Corporation",
      "peak_day_posts": 930,
      "peak_timestamp": "2026-09-10T14:00:00Z",
      "series": [
        {
          "posts": 41,
          "timestamp": "2026-09-10T13:00:00Z"
        },
        {
          "posts": 112,
          "timestamp": "2026-09-10T14:00:00Z"
        },
        {
          "posts": 64,
          "timestamp": "2026-09-10T15:00:00Z"
        }
      ],
      "symbol": "ORCL"
    }
  ],
  "days": 30
}