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

REST API
소셜 & 센티먼트

소셜 모멘텀

GET /social-momentum

GetSocialMomentum

자산, 주제 또는 전체 시장에 대해 각 작성자 클러스터 내부의 게시물, 고유 작성자, 감성을 나란히 보여줍니다. 어떤 그룹이 대화를 주도하고 있으며 그들의 어조가 어떻게 다른지 알 수 있습니다. 클러스터는 서로 겹치므로 합산하지 마세요. 지정한 클러스터만 반환하려면 clusters을 전송하세요.

파라미터 규칙:

asset_id는 asset_class와 함께 보내야 합니다.
subject_id는 asset_id 또는 asset_class와 함께 사용할 수 없습니다.
asset_id 없이 asset_class를 사용하려면 equity 또는 crypto여야 하며, commodity와 index에는 asset_id이 필요합니다.

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

파라미터

asset_id string QUERY

/assets 또는 /search에서 가져온 자산 ID입니다(예: NVDA, GLD, SPX, bitcoin). 함께 반환된 asset_class와 같이 보내세요.

Example:NVDA

asset_class string QUERY

asset_id가 있으면 해당 자산의 클래스입니다. 없으면 집계할 시장으로, equity(주식, 원자재, 지수이며 기본값) 또는 crypto입니다.

허용 값

equitycommodityindexcrypto

Example:equity

subject_id string QUERY

/subjects 또는 /search가 반환하는 정규 비자산 식별자로, 예를 들어 text:jensen huang 또는 handle:elonmusk입니다. 대소문자를 구분하지 않고 허용됩니다. asset_id 또는 asset_class와 함께 사용할 수 없습니다.

Example:text:jensen huang

hours integer QUERY

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

Default:168

granularity string QUERY

요청한 시계열 버킷 크기입니다. 생략하면 서비스가 조회 기간(lookback window)에 적합한 버킷 크기를 선택합니다.

허용 값

1h2h4h12h1d

Example:1h

clusters array<string> QUERY

이 클러스터들만 각각 별도의 시계열로 반환합니다. 생략하면 전체를 반환합니다. /sentiment의 clusters 파라미터에서 가져온 id를 사용하되, 게시 커뮤니티는 제외합니다.

Example:smart_money

cURL 예제

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

응답

200 OK

400 잘못된 요청

401 인증되지 않음

402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.

403 금지됨

404 찾을 수 없음

405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.

429 요청이 너무 많음

500 내부 서버 오류

503 서비스 이용 불가

미디어 타입 application/json

clusters

object 필수

정규 작성자 클러스터 식별자를 키로 하는 소셜 모멘텀 시계열입니다.

clusters.{key}[].average_sentiment_score

number (double) 필수

게시물 감성 점수의 산술 평균으로, −100(매우 약세)에서 +100(매우 강세) 척도를 따릅니다.

clusters.{key}[].bearish_posts

integer (int64) 필수

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

clusters.{key}[].bullish_posts

integer (int64) 필수

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

clusters.{key}[].neutral_posts

integer (int64) 필수

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

clusters.{key}[].timestamp

string (date-time) 필수

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

clusters.{key}[].total_posts

integer (int64) 필수

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

clusters.{key}[].unique_posters

integer (int64) 필수

버킷 내 고유 게시 계정 수입니다. 시간 단위보다 거친 집계에서는 시간별 집계를 합산한 상한값입니다.

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}