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

관련 주제

GET /related-subjects
GetRelatedSubjects

자산이나 주제와 같은 게시물에서 가장 자주 함께 언급되는 인물, 계정, 주제입니다. share은 앵커 게시물 중 공유 게시물의 비율이며, 감성 필드는 해당 공유 게시물 내에서의 앵커 감성입니다.

파라미터 규칙:

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

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

limit integer QUERY

반환되는 최대 결과 수.

Default:25

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --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

authors
integer (int64) 필수

일치하는 게시물을 작성한 고유 작성자 수입니다.

average_sentiment_score
number (double) 필수

요청한 기간 내 모든 앵커 게시물의 평균 감성 점수입니다.

from
string (date-time) 필수

측정 기간의 시작 시각(UTC, 포함).

hours
integer 필수

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

posts
integer (int64) 필수

요청한 기간 동안 일치하는 게시물 수입니다.

subjects
array<object> 필수

discovery 작업이 반환하는 비자산 주제입니다.
subjects[].authors
integer (int64) 필수

일치하는 게시물을 작성한 고유 작성자 수입니다.

subjects[].bearish_posts
integer (int64) 필수

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

subjects[].bullish_posts
integer (int64) 필수

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

subjects[].first_post_at
string (date-time) 선택 사항

요청한 기간 내 첫 번째 일치 게시물의 시각(UTC)입니다.

subjects[].last_post_at
string (date-time) 선택 사항

요청한 기간 내 가장 최근 일치 게시물의 시각(UTC)입니다.

subjects[].name
string 필수

사람이 읽을 수 있는 이름입니다.

subjects[].neutral_posts
integer (int64) 필수

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

subjects[].posts
integer (int64) 필수

요청한 기간 동안 일치하는 게시물 수입니다.

subjects[].posts_delta
number (double) 필수

posts_prior에서 posts_recent로의 변화율입니다. 양수는 증가를 나타냅니다.

subjects[].posts_prior
integer (int64) 필수

요청한 기간의 전반부에 해당하는 일치 게시물입니다.

subjects[].posts_recent
integer (int64) 필수

요청한 기간의 후반부에 해당하는 일치 게시물입니다.

subjects[].sentiment_delta
number (double) 필수

공유 대화의 sentiment_score와 앵커의 전체 기간 평균 간의 차이입니다.

subjects[].sentiment_score
number (double) 필수

부호가 있는 감성 점수로, 양수는 강세, 음수는 약세입니다.

subjects[].share
number (double) 필수

이 주제를 함께 언급한 앵커 게시물의 비율을, 해당 기간 내 전체 앵커 게시물 대비 소수로 나타낸 값입니다.

subjects[].subject_id
string 필수

자산이 아닌 인물, 계정 또는 주제의 정규 식별자입니다.

to
string (date-time) 필수

측정 기간의 종료 시각(UTC, 미포함).

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}