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

작성자 클러스터

GET /clusters
ListClusters

한 시장에서 모든 작성자 클러스터의 활동과 감성: 게시물, 고유 작성자, 이전 창 대비 변화, 그리고 시간별 시계열을 포함한 순 감성(강세 게시물에서 약세 게시물을 뺀 값)입니다. asset_class은 equity(기본값) 또는 crypto입니다.

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

파라미터

asset_class string QUERY

집계할 시장: equity(주식, 원자재, 지수를 함께 포괄하는 전통 시장) 또는 crypto입니다.

허용 값
equitycrypto

Default:equity

hours integer QUERY

시간 단위의 조회 기간입니다. 무료 플랜은 90일까지 조회할 수 있으며, 그 이후는 403을 반환합니다.

Default:24

cURL 예제

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK
400 잘못된 요청
401 인증되지 않음
402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.
403 금지됨
404 찾을 수 없음
405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.
429 요청이 너무 많음
500 내부 서버 오류
503 서비스 이용 불가

미디어 타입 application/json

clusters
array<object> 필수

선택한 자산 클래스에 대한 작성자 클러스터 요약입니다.
clusters[].activity_change_pct
number (double) 선택 사항

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

clusters[].bearish_posts
number (double) 필수

약세로 분류된 게시물입니다.

clusters[].bullish_posts
number (double) 필수

강세로 분류된 게시물입니다.

clusters[].cluster_id
string 필수

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

clusters[].neutral_posts
number (double) 필수

중립으로 분류된 게시물입니다.

clusters[].previous_total_posts
number (double) 필수

동일한 길이의 바로 이전 창의 게시물 수입니다.

clusters[].recent_sentiment_signal
number (double) 필수

시간별 감성 시계열의 최신 값: 게시물이 있는 가장 최근 시간입니다.

clusters[].series
array<object> 필수

시간순으로 정렬된 관측값입니다.
clusters[].series[].bearish_posts
number (double) 필수

약세로 분류된 게시물입니다.

clusters[].series[].bullish_posts
number (double) 필수

강세로 분류된 게시물입니다.

clusters[].series[].sentiment_signal
number (double) 필수

감쇠 가중 순 강세 게시물로, 강세에서 약세를 뺀 값입니다. 양수는 강세, 음수는 약세이며, 활동량이 많을수록 크기가 커집니다.

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

관측값 또는 버킷 시작 시점의 UTC RFC 3339 타임스탬프입니다.

clusters[].series[].total_posts
number (double) 필수

지표의 활성 조회 기간 동안의 게시물 수입니다.

clusters[].total_posts
number (double) 필수

지표의 활성 조회 기간 동안의 게시물 수입니다.

clusters[].window_sentiment_signal
number (double) 필수

요청한 전체 창에 대한 순 강세 감성 신호입니다.

hours
integer 필수

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

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}