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

클러스터 하이프 사이클

GET /clusters/hype-cycles
GetClusterHypeCycles

한 클러스터가 시장보다 하이프 사이클에 얼마나 일찍 도착하는지를 나타냅니다. curve은 피크 7일 전부터 7일 후까지 각 진영 게시물의 누적 비율이므로 선이 왼쪽에 있을수록 더 이릅니다. lead_days는 클러스터의 리드(양수면 이름)이고, clusters는 모든 클러스터의 리드를 순위로 매깁니다.

파라미터 규칙:

  • cluster_id을 전송합니다.
  • cluster_id은 클러스터 하나를 지정합니다. 여러 클러스터를 비교하려면 클러스터마다 한 번씩 호출하거나, /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 중 하나 이상을 쉼표로 구분해 지정합니다. 기본값은 네 가지 모두입니다. 여러 개를 쉼표로 구분해 전송하세요.

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를 생략한 경우에는 네 가지 모두입니다.

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까지 하루에 한 포인트입니다. 완료된 사이클이 없으면 비어 있습니다.
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
}