전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON
  1. REST API
  2. 인텔리전스

인텔리전스

GET /insights
ListInsights

시장 전반 또는 특정 자산이나 주체에 대해 무슨 일이 일어나고 있는지 다루는 짧은 스토리로, 각각 헤드라인, 요약, 감성(−1, 0, +1), 태그, 1에서 3까지의 중요도, 관련 엔티티를 포함합니다. 최근 업데이트순으로 정렬되며, 최신 이벤트를 먼저 보려면 order_by=start_time_desc를 보내세요.

파라미터 규칙:

  • asset_class와 asset_id를 함께 보내거나 둘 다 보내지 마세요.
  • subject_id는 asset_id 또는 asset_class와 함께 사용할 수 없습니다.

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

limit integer QUERY

반환되는 최대 결과 수.

Default:10

offset integer QUERY

건너뛴 결과 수.

Default:0

start_time_after string (date-time) QUERY

이 RFC3339 시각 이후에 시작하는 항목만. 무료 플랜은 90일 전까지 조회할 수 있으며, 그보다 이전은 403을 반환합니다.

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

이 RFC3339 시각 이전에 시작하는 항목만. 무료 플랜은 90일 전까지 조회할 수 있으며, 그보다 이전은 403을 반환합니다.

Example:2026-08-07T00:00:00Z

tags array<string> QUERY

이 태그 중 하나라도 정확히 일치하는 스토리를 유지합니다(예: earnings). 태그는 자유 형식 레이블이므로 반환된 스토리에서 확인하세요. 여러 개를 쉼표로 구분해 보내세요.

Example:earnings

exclude_tags array<string> QUERY

이 태그 중 하나라도 가진 스토리를 제외합니다. 태그만 일치하며 카테고리나 도메인은 일치하지 않습니다. 암호화폐 스토리를 제외하려면 대신 도메인을 필터링하세요. 여러 개를 쉼표로 구분해 보내세요.

Example:rumour

categories array<string> QUERY

기본 카테고리가 이 중 하나와 정확히 일치하는 스토리를 유지합니다(예: equities 또는 technology). 카테고리는 자유 형식이므로 반환된 스토리에서 확인하세요. 여러 개를 쉼표로 구분해 보내세요.

Example:equities

domains array<string> QUERY

이 도메인 중 하나에 속하는 스토리를 유지합니다. 여러 개를 쉼표로 구분해 보내세요.

Example:equities,macro

order_by string QUERY

결과 정렬 순서. 기본값은 updated_at_desc입니다.

허용 값
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

cURL 예제

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

응답

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

미디어 타입 application/json

insights
array<object> 필수

제공된 필터와 일치하는 큐레이션된 인텔리전스 항목.
insights[].category
string 선택 사항

지정된 경우 기본 인텔리전스 카테고리.

insights[].domains
array<string> 필수

레코드에 연결된 시장 또는 주체 도메인.

insights[].entities
array<object> 필수

이 레코드에 연결된 자산 및 비자산 주체.
insights[].entities[].asset_class
string 선택 사항

asset_id와 함께 전송되는 자산의 클래스.

허용 값
equitycommodityindexcrypto
insights[].entities[].asset_id
string 선택 사항

주식, 원자재, 지수 또는 코인의 경우 자산 엔드포인트가 받는 asset_id이며, 인물, 계정, 토픽과 Nebula가 분류할 수 없는 드문 자산에는 없습니다.

insights[].entities[].entity_id
string 필수

eq:NVDA, gecko:1, text:ai 등 연결된 엔티티에 대한 Nebula의 id입니다. 엔티티를 쿼리하려면 같은 객체의 asset_id와 asset_class, 또는 subject_id를 사용하세요.

insights[].entities[].entity_types
array<string> 필수

연결된 엔티티에 대한 지식 그래프 분류.

insights[].entities[].is_direct
boolean 필수

레코드가 이 연결된 엔티티와 직접 관련된 경우 true입니다.

insights[].entities[].is_primary
boolean 필수

이것이 레코드의 기본 연결 엔티티인 경우 true입니다.

insights[].entities[].name
string 필수

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

insights[].entities[].role
string 필수

인텔리전스 항목에 대한 연결된 엔티티의 관계.

insights[].entities[].subject_id
string 선택 사항

인물, 계정 또는 토픽의 경우 주체 인식 엔드포인트가 받는 subject_id이며, 자산에는 없습니다.

insights[].headline
string 필수

간결한 인텔리전스 헤드라인.

insights[].importance_score
integer 필수

중요도는 1(낮음)에서 3(높음)까지입니다.

insights[].insight_id
integer (int64) 필수

인텔리전스 항목의 안정적인 식별자.

insights[].sentiment_score
integer 필수

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

insights[].start_time
string (date-time) 선택 사항

인텔리전스 항목 또는 이벤트가 시작되는 UTC 시각.

insights[].summary
string 필수

인텔리전스 항목에 대한 근거 기반 요약입니다.

insights[].tags
array<string> 필수

레코드에 첨부된 검색 가능한 레이블입니다.

insights[].updated_at
string (date-time) 선택 사항

레코드가 마지막으로 업데이트된 UTC 시각입니다.

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary",
          "subject_id": "text:jensen huang"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 3,
      "insight_id": 38421,
      "sentiment_score": 1,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}