전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. 소셜 & 센티먼트

센티먼트

GET /sentiment
GetSentiment

자산, 주제 또는 전체 시장에 대한 대화가 시간 경과에 따라 얼마나 강세 또는 약세인지를 나타냅니다. sentiment_signal는 최근 24시간 동안의 강세 게시물에서 약세 게시물을 뺀 값이며, 최근 게시물에 더 높은 가중치를 둡니다. 양수는 순 강세를 의미합니다. 게시물 양이 늘어날수록 값도 커지므로, 자산은 자체 이력과 비교해야 합니다.

cohorts는 봇과, 자산 또는 주제 하나에 대해서는 top callers에 대해 동일한 측정값을 제공합니다. 하나 이상의 작성자 그룹을 조회하려면 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/sentiment에서 월렛 결제를 사용할 수 있습니다. 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

읽을 작성자 클러스터로, 반복해서 지정하면 결합됩니다(예: clusters=kols&clusters=media). 선택한 클러스터는 합산되며, 한 작성자가 여러 클러스터에 속할 수 있습니다.

  • Callers: smart_money(성과가 가장 좋은 콜러), dumb_money(성과가 가장 나쁜 콜러), top_degens(소형주 크립토에서 가장 우수한 콜러)
  • Timing: early_movers(관심이 높아질 때 자산에 대해 가장 먼저 언급), late_movers(정점이나 그 이후에 진입)
  • 빌더: developers, founders, team_leaders, project_accounts
  • 기관: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • 인플루언스: kols, celebrities, media, marketer, shiller
  • 애널리스트: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • 트레이더: position_trader, swing_trader, day_trader
  • 바이어스: perma_bull, doomer, tribalist
  • 기타: political, nft, bots, automated_ai
  • 게시 위치에 따른 커뮤니티: wallstreetbets, reddit

Example:smart_money

cURL 예제

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

응답

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

미디어 타입 application/json

cohorts
object 필수

다른 작성자 그룹에 대한 동일한 측정값입니다. 즉 봇과, 해당 모집단을 사용할 수 있을 때의 top_callers입니다. 비봇 모집단은 series 자체입니다.

허용되는 키
botstop_callers
cohorts.{key}[].bearish_posts
number (double) 필수

이 시점에서 끝나는 최근 24시간 동안의 약세 게시물입니다. interval_bearish_posts는 해당 버킷의 값입니다.

cohorts.{key}[].bullish_posts
number (double) 필수

이 시점에서 끝나는 최근 24시간 동안의 강세 게시물입니다. interval_bullish_posts는 해당 버킷의 값입니다.

cohorts.{key}[].interval_bearish_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 약세 게시물입니다.

cohorts.{key}[].interval_bullish_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 강세 게시물입니다.

cohorts.{key}[].interval_neutral_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 중립 게시물입니다.

cohorts.{key}[].interval_posts
number (double) 선택 사항

조회 기간 누적 전, 이번에 출력된 시간 버킷의 게시물입니다.

cohorts.{key}[].neutral_posts
number (double) 필수

이 시점에서 끝나는 최근 24시간 동안의 중립 게시물입니다. interval_neutral_posts는 해당 버킷의 값입니다.

cohorts.{key}[].sentiment_signal
number (double) 필수

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

cohorts.{key}[].timestamp
string (date-time) 필수

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

cohorts.{key}[].total_posts
number (double) 필수

이 버킷만이 아니라 이 시점에서 끝나는 최근 24시간 동안의 게시물입니다. interval_posts는 해당 버킷의 값입니다.

series
array<object> 필수

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

이 시점에서 끝나는 최근 24시간 동안의 약세 게시물입니다. interval_bearish_posts는 해당 버킷의 값입니다.

series[].bullish_posts
number (double) 필수

이 시점에서 끝나는 최근 24시간 동안의 강세 게시물입니다. interval_bullish_posts는 해당 버킷의 값입니다.

series[].interval_bearish_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 약세 게시물입니다.

series[].interval_bullish_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 강세 게시물입니다.

series[].interval_neutral_posts
number (double) 선택 사항

이번에 출력된 시간 버킷의 중립 게시물입니다.

series[].interval_posts
number (double) 선택 사항

조회 기간 누적 전, 이번에 출력된 시간 버킷의 게시물입니다.

series[].neutral_posts
number (double) 필수

이 시점에서 끝나는 최근 24시간 동안의 중립 게시물입니다. interval_neutral_posts는 해당 버킷의 값입니다.

series[].sentiment_signal
number (double) 필수

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

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

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

series[].total_posts
number (double) 필수

이 버킷만이 아니라 이 시점에서 끝나는 최근 24시간 동안의 게시물입니다. interval_posts는 해당 버킷의 값입니다.

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}