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

감정 분포

GET /emotions
GetEmotions

시간에 따라 자산 또는 주제에 대한 대화를 지배하는 15가지 감정은 무엇인지 보여줍니다. proportion은 버킷의 감정 중 각 감정이 차지하는 비중(합이 1이 됨)이고, post_count는 해당 감정을 나타내는 게시물을 셉니다. 하나의 게시물이 여러 감정을 나타낼 수 있습니다.

파라미터 규칙:

  • asset_id 또는 subject_id를 보내세요.
  • asset_id는 asset_class와 함께 보내야 합니다.
  • subject_id는 asset_id 또는 asset_class와 함께 사용할 수 없습니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/emotions에서 월렛 결제를 사용할 수 있습니다. 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(주식 및 ETF), commodity, index, crypto 중 하나입니다. /assets 또는 /search가 asset_id와 함께 반환한 asset_class를 보내세요.

허용 값
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:720

granularity string QUERY

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

허용 값
1h2h4h12h1d

Example:1h

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/emotions' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

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

미디어 타입 application/json

metadata
object 선택 사항

응답을 해석하는 데 필요한 방법론 및 요청 기간 메타데이터입니다.
metadata.empty_bucket_policy
string 필수

데이터 없이 생략되거나 출력된 버킷을 클라이언트가 해석하는 방법입니다.

metadata.empty_buckets
integer 필수

조건을 충족하는 데이터가 없는 버킷 수입니다.

metadata.granularity
string 필수

반환된 시계열에서 사용된 시간 버킷 크기입니다.

metadata.hours
integer 필수

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

metadata.latest_empty_bucket
string (date-time) 선택 사항

조건을 충족하는 데이터가 없는 가장 최근 UTC 버킷입니다.

series
object 필수

감지된 감정 레이블을 키로 하는 감정 관측값입니다.

허용되는 키
angeranticipationboredomconfidencedisgustdistrustfeargreedjoyloveoptimismpessimismsadnesssurprisetrust
series.{key}[].post_count
integer (int64) 필수

버킷에서 이 감정을 담은 게시물의 원시 개수입니다.

series.{key}[].proportion
number (double) 필수

버킷의 모든 감정 태그 중 이 감정이 차지하는 비중으로, 0에서 1입니다.

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

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

{
  "series": {
    "optimism": [
      {
        "post_count": 286,
        "proportion": 0.37,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ]
  }
}