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

REST API
소셜 & 센티먼트

시간대별 심리

GET /sentiment/timeframes

GetSentimentTimeframes

사람들이 이야기하는 기간별로 구분한 감성입니다. 단기(최대 1주), 중기(수주~수개월), 장기(3개월 이상)로 나뉘며, 각각 /sentiment 척도를 따릅니다. 이번 주에는 약세지만 연간으로는 강세인 군중과, 전 기간에 걸쳐 약세인 군중을 구분합니다.

파라미터 규칙:

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

https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes에서 월렛 결제를 사용할 수 있습니다. 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/sentiment/timeframes' \
  --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

current

object 필수

사용 가능한 각 시간 지평별 최신 감성 값입니다.

허용되는 키

short_termmedium_termlong_term

metadata

object 선택 사항

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

metadata.as_of

string (date-time) 선택 사항

지표가 계산된 시각(UTC)입니다.

metadata.calculation

string 선택 사항

계산 방식의 짧은 이름입니다.

metadata.formula

string 선택 사항

계산식을 사람이 읽을 수 있는 형태로 나타낸 것입니다.

metadata.half_life_hours

number (double) 선택 사항

이름과 달리, 선형 감쇠 윈도의 길이를 시간 단위로 나타낸 값입니다. 게시물은 최신일 때 온전히 반영되고, 중간 지점에서는 절반, 이만큼 오래되면 전혀 반영되지 않습니다.

metadata.lookback_days

integer 선택 사항

계산에 사용되는 과거 조회 기간(일)입니다.

metadata.scale

string 선택 사항

지표에 대해 공개된 척도 또는 해석입니다.

series

object 필수

short_term, medium_term, long_term 지평을 키로 하는 감성 시계열입니다.

허용되는 키

short_termmedium_termlong_term

series.{key}[].interval_posts

number (double) 선택 사항

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

series.{key}[].sentiment_signal

number (double) 필수

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

series.{key}[].timestamp

string (date-time) 필수

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

series.{key}[].total_posts

number (double) 선택 사항

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}