전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON

REST API
클러스터

클러스터 비교

GET /clusters/comparison

CompareClusters

창 동안 모든 작성자 클러스터를 나란히 비교: 게시물과 그 변화, 시장 대비 강세 정도(cluster_bullish_share 대 market_bullish_share), 지난 7일 동안 가장 많이 전환한 자산(trending_asset), 그리고 일별 게시물입니다.

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

파라미터

asset_class array<string> QUERY

비교할 시장: equity, commodity, index, crypto 중 하나 이상을 쉼표로 구분합니다. 기본값은 네 가지 모두입니다. 여러 개를 쉼표로 구분해 보내세요.

Default:equity,commodity,index,crypto

days integer QUERY

최신 완전 UTC 일자부터 거슬러 계산하여 비교할 완전 UTC 일수: 7, 30 또는 90입니다. activity_change_pct는 그 이전의 동일한 일수와 비교합니다. 무료 플랜은 90일 전까지 조회할 수 있으며, 그 이전은 403을 반환합니다.

허용 값

73090

Default:30

cURL 예제

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

clusters

array<object> 필수

창 내에 게시물이 있는 모든 클러스터로, 게시물이 많은 순서입니다.

clusters[].activity_change_pct

number (double) 필수

동일한 길이의 이전 창 대비 게시물의 퍼센트 변화입니다(84 다음에 76이면 -9.52). 비교가 불가능할 때는 존재하지 않습니다.

clusters[].bearish_posts

integer (int64) 필수

창 동안 해당 클러스터의 약세 게시물입니다.

clusters[].bullish_posts

integer (int64) 필수

창 동안 해당 클러스터의 강세 게시물입니다.

clusters[].cluster_bullish_share

number (double) 필수

창 동안 해당 클러스터의 강세 ÷ (강세 + 약세) 게시물 비율로, 0에서 1 사이입니다. 강세 또는 약세 게시물이 없으면 null입니다.

clusters[].cluster_id

string 필수

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

clusters[].market_bullish_share

number (double) 필수

해당 클러스터가 읽는 시장의 동일한 일수 및 자산 클래스에 대한 같은 비율입니다(게시 커뮤니티의 경우 equity 시장). baseline cluster_bullish_share가 비교하는 대상입니다. 강세 또는 약세 게시물이 없으면 null입니다.

clusters[].posts

integer (int64) 필수

창 동안 해당 클러스터의 게시물입니다.

clusters[].series

array<object> 필수

윈도우의 모든 완전한 UTC 일자로, 가장 오래된 날짜부터 시작하며 게시물이 없는 날도 포함됩니다.

clusters[].series[].bearish_posts

integer (int64) 필수

해당 일자의 클러스터의 약세 게시물입니다.

clusters[].series[].bullish_posts

integer (int64) 필수

해당 일자의 클러스터의 강세 게시물입니다.

clusters[].series[].posts

integer (int64) 필수

해당 일자의 클러스터의 게시물입니다.

clusters[].series[].timestamp

string (date-time) 필수

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

clusters[].trending_asset

object 필수

지난 7개의 완전한 일자 동안 클러스터가 시장보다 더 많이 관심을 돌린 자산이며, 해당하는 자산이 없으면 null입니다.

clusters[].trending_asset.asset_class

string 필수

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

허용 값

equitycommodityindexcrypto

clusters[].trending_asset.asset_id

string 필수

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

clusters[].trending_asset.name

string 필수

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

clusters[].trending_asset.symbol

string 필수

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

days

integer 필수

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}