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

클러스터 로테이션

GET /clusters/rotation
GetClusterRotation

한 클러스터의 관심이 어디로 이동하는지 보여줍니다. 이전 기간 대비 게시물 점유율이 늘어난 자산과 줄어든 자산을 베이시스 포인트로 나타내고, 게시물이 시장, 인물, 이벤트에 어떻게 나뉘는지도 보여줍니다.

파라미터 규칙:

  • cluster_id을 전송합니다.
  • cluster_id은 클러스터 하나를 지정합니다. 여러 클러스터를 비교하려면 클러스터마다 한 번씩 호출하거나, /clusters를 사용해 모든 클러스터를 한 번에 가져오세요.
  • 게시 커뮤니티(wallstreetbets, reddit)는 주식만 다룹니다. 둘 중 하나를 사용할 경우 asset_class에 equity이 포함되어야 합니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/rotation에서 월렛 결제를 사용할 수 있습니다. 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

hours integer QUERY

같은 길이의 직전 기간과 비교할 기간: 24(최근 24시간), 168(최근 7일 전체), 720(최근 30일 전체). 무료 플랜은 90일 전까지만 조회할 수 있으며, 그보다 이전을 요청하면 403을 반환합니다.

허용 값
24168720

Default:168

limit integer QUERY

반환되는 최대 상승 자산 수이며, 하락 자산에도 별도로 적용됩니다.

Default:6

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/rotation' \
  --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로 표시됩니다.

gainers
array<object> 필수

클러스터 게시물 점유율이 가장 많이 오른 자산으로, 상승 폭이 큰 순서입니다. 점유율이 오른 자산만 나열됩니다.
gainers[].asset_class
string 필수

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

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

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

gainers[].current_share
number (double) 필수

현재 기간에 선택한 자산 클래스에 대한 클러스터 전체 게시물 중 해당 자산의 게시물 비율로, 0부터 1까지입니다.

gainers[].name
string 필수

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

gainers[].previous_share
number (double) 필수

비교 기간에 클러스터 전체 게시물 중 해당 자산의 게시물 비율로, 0부터 1까지입니다.

gainers[].share_change_bps
integer 필수

current_share에서 비교 기간의 점유율을 뺀 값(베이시스 포인트): 100은 1퍼센트 포인트입니다. 음수면 점유율이 하락한 것입니다.

gainers[].symbol
string 필수

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

hours
integer 필수

응답이 나타내는 조회 기간(lookback window)으로, 시간 단위입니다.

losers
array<object> 필수

클러스터 게시물 점유율이 가장 많이 떨어진 자산으로, 하락 폭이 큰 순서입니다. 점유율이 떨어진 자산만 나열됩니다.
losers[].asset_class
string 필수

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

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

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

losers[].current_share
number (double) 필수

현재 기간에 선택한 자산 클래스에 대한 클러스터 전체 게시물 중 해당 자산의 게시물 비율로, 0부터 1까지입니다.

losers[].name
string 필수

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

losers[].previous_share
number (double) 필수

비교 기간에 클러스터 전체 게시물 중 해당 자산의 게시물 비율로, 0부터 1까지입니다.

losers[].share_change_bps
integer 필수

current_share에서 비교 기간의 점유율을 뺀 값(베이시스 포인트): 100은 1퍼센트 포인트입니다. 음수면 점유율이 하락한 것입니다.

losers[].symbol
string 필수

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

topic_changes
array<object> 필수

현재 기간에 각 토픽이 차지하는 비중과 이전 기간 대비 변화를 equity, commodity, index, crypto, people, events 순서로 나타냅니다.
topic_changes[].current_share
number (double) 필수

현재 기간에 클러스터 게시물 중 해당 토픽의 비중으로, 0부터 1까지입니다.

topic_changes[].share_change_bps
integer 필수

이전 기간 대비 비중 변화(베이시스 포인트, 100은 1퍼센트 포인트).

topic_changes[].topic
string 필수

equity, commodity, index, crypto, people(인물 및 그 계정) 또는 events(장소, 테마 및 이벤트).

허용 값
equitycommodityindexcryptopeopleevents
topic_series
array<object> 필수

UTC 기준 완전한 날짜별 클러스터 게시물 중 각 토픽의 비중으로, 오래된 날짜부터 정렬됩니다.
topic_series[].timestamp
string (date-time) 필수

해당 일자의 UTC 시작 시각: 00:00.

topic_series[].topics
array<object> 필수

해당 날짜에 클러스터 게시물 중 각 토픽의 비중으로, topic_changes 순서를 따릅니다. 클러스터가 그날 게시물을 올렸다면 비중의 합은 1입니다.
topic_series[].topics[].topic
string 필수

equity, commodity, index, crypto, people(인물 및 그 계정) 또는 events(장소, 테마 및 이벤트).

허용 값
equitycommodityindexcryptopeopleevents
topic_series[].topics[].topic_share
number (double) 필수

해당 날짜에 클러스터 게시물 중 해당 토픽의 비중으로, 0부터 1까지입니다.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}