Nebula 퍼블릭 API
레퍼런스 색인
아래의 모든 엔드포인트에는 안정적인 HTML 페이지와 Markdown 버전이 있습니다. 이 인덱스는 정적이며 크롤링이 가능하고, AI 에이전트가 JavaScript를 실행하지 않고도 안전하게 읽을 수 있습니다.
디스커버리
엔드포인트 3개/screener
스크리너
하나의 24시간 지표로 자산 또는 주제의 순위를 매기고 나머지 지표로 필터링합니다: share, share change, posts, net bullish posts(강세에서 약세를 뺀 값, 음수는 약세), 또는 24-hour price change. 범위는 양 끝값을 포함하며 서로 결합되고, 가격 필터는 자산에만 적용됩니다.
/top-momentum
상위 모멘텀
대화에서 비중을 가장 빠르게 늘리는 자산 또는 주제: 이번 24시간의 비중에서 이전 24시간의 비중을 뺀 값입니다. share_change_pct은 어제 비중 대비 동일한 변화입니다.
/top-trending
상위 트렌딩
지난 24시간 동안 대화에서 가장 큰 비중을 차지한 자산 또는 주제를 비중이 높은 순서대로 나열하며, 직전 24시간 대비 변화도 함께 제공합니다.
조회
엔드포인트 3개/assets
텍스트 → 자산 ID
이름이나 티커로 주식과 ETF, 원자재, 지수, 암호화폐를 조회하고, 모든 자산 엔드포인트가 받는 asset_id과 asset_class를 가져옵니다. 검색하려면 query을, 정확히 일치하는 항목을 찾으려면 asset_id를 보내고, 둘 다 보내지 않으면 가장 활발한 자산을 둘러봅니다.
/search
검색
자산, 인물, 계정, 토픽을 한 번에 검색합니다. 각 결과의 kind는 어떤 유형인지 알려줍니다. 자산에는 asset_id와 asset_class가, 주체에는 subject_id가 포함됩니다. 한쪽만 검색하려면 kind를 보내세요.
/subjects
텍스트 → 주체 ID
AI를 포함한 사람, 계정, 주제를 조회하고, 주제 엔드포인트가 받는 subject_id을 가져옵니다. 자산은 포함되지 않으므로 자산에는 /assets 또는 /search를 사용하세요.
소셜 & 센티먼트
엔드포인트 6개/emotions
감정 분포
시간에 따라 자산 또는 주제에 대한 대화를 지배하는 15가지 감정은 무엇인지 보여줍니다. proportion은 버킷의 감정 중 각 감정이 차지하는 비중(합이 1이 됨)이고, post_count는 해당 감정을 나타내는 게시물을 셉니다. 하나의 게시물이 여러 감정을 나타낼 수 있습니다.
/mindshare
마인드셰어
자산 또는 주체가 대화에서 차지하는 비중: 해당 시장(주식, 암호화폐 또는 인물과 토픽)의 전체 게시물 중 최근 24시간 동안의 게시물 비율로, 0에서 1 사이입니다. 하나 이상의 작성자 그룹 내에서 비중을 측정하려면 clusters를 보내세요.
/related-subjects
관련 주제
자산이나 주제와 같은 게시물에서 가장 자주 함께 언급되는 인물, 계정, 주제입니다. share은 앵커 게시물 중 공유 게시물의 비율이며, 감성 필드는 해당 공유 게시물 내에서의 앵커 감성입니다.
/sentiment
센티먼트
자산, 주제 또는 전체 시장에 대한 대화가 시간 경과에 따라 얼마나 강세 또는 약세인지를 나타냅니다. sentiment_signal는 최근 24시간 동안의 강세 게시물에서 약세 게시물을 뺀 값이며, 최근 게시물에 더 높은 가중치를 둡니다. 양수는 순 강세를 의미합니다. 게시물 양이 늘어날수록 값도 커지므로, 자산은 자체 이력과 비교해야 합니다.
/sentiment/timeframes
시간대별 심리
사람들이 이야기하는 기간별로 구분한 감성입니다. 단기(최대 1주), 중기(수주~수개월), 장기(3개월 이상)로 나뉘며, 각각 /sentiment 척도를 따릅니다. 이번 주에는 약세지만 연간으로는 강세인 군중과, 전 기간에 걸쳐 약세인 군중을 구분합니다.
/social-momentum
소셜 모멘텀
자산, 주제 또는 전체 시장에 대해 각 작성자 클러스터 내부의 게시물, 고유 작성자, 감성을 나란히 보여줍니다. 어떤 그룹이 대화를 주도하고 있으며 그들의 어조가 어떻게 다른지 알 수 있습니다. 클러스터는 서로 겹치므로 합산하지 마세요. 지정한 클러스터만 반환하려면 clusters을 전송하세요.
예측
엔드포인트 3개/forecasts/assets
예측 가능 자산
현재 예측이 있는 모든 자산입니다. 이 목록은 동일한 자산을 예측하는 /forecasts/mindshare와 /forecasts/sentiment를 모두 포함하므로, 자산의 asset_id과 asset_class를 어느 쪽에든 전달하면 됩니다. 주식, 원자재, 지수가 먼저 나오고 그다음 암호화폐가 나오며, 각각 가장 많이 논의된 순서입니다. 목록은 5분마다 갱신됩니다.
/forecasts/mindshare
마인드셰어 예측
향후 72시간 동안 자산의 마인드셰어가 어디에 있을지 가능성과 함께 결과 범위로 나타낸 것입니다. series은 4시간마다의 분포를 제공하고, chance_higher_72h와 likely_low_share에서 likely_high_share는 결과가 어디에 위치하는지 요약하며, takeoff_chance_72h는 관심이 급증할 가능성입니다.
/forecasts/sentiment
심리 예측
향후 72시간 동안 자산의 심리가 어디로 향할 가능성이 있는지를 결과 범위와 그 확률로 나타냅니다. series는 4시간마다 해당 스텝에서 예상되는 강세, 약세, 중립, 전체 게시물 수와 스텝 끝의 sentiment_signal를 /sentiment 스케일로 제공합니다. chance_higher_24h와 chance_higher_72h는 신호가 current_sentiment_signal 위에서 마감할 확률을 제공하며, 각각의 _confident 플래그는 그 확률이 명확히 한쪽으로 기울 때를 표시합니다.
시장 센티먼트
엔드포인트 7개/calls
롱/숏 콜
자산 또는 모든 시장 전반에 걸쳐 사람들이 시간에 따라 얼마나 많은 롱 콜과 숏 콜을 하는지를 나타냅니다. 콜은 자산이 상승하거나 하락할 것이라고 말하거나, 포지션을 공개하거나, 다른 사람에게 포지션을 취하라고 권하는 것을 뜻하며, 단순한 의견은 포함되지 않습니다. 한 그룹의 콜을 집계하려면 clusters을 전송하세요.
/calls/returns
콜 결과 분포
최근 콜의 성과를 나타냅니다. 승률, 중앙값 및 평균 수익률, 수익률 분포를 포함합니다. 각 콜은 콜 이후 24시간 동안의 가격 변동을 콜한 사람의 관점에서 평가하므로, 10% 하락에 대한 숏 콜은 +10%가 됩니다. 그룹을 비교하려면 clusters을 전송하세요. 예를 들어 smart_money와 dumb_money을 비교할 수 있습니다.
/conviction-index
확신 지수
자산에 대한 신뢰가 얼마나 강한지를 0–100으로 나타낸 값입니다. 자산의 강세 비율을 시장의 강세 비율과 비교한 값, 가격이 하락하는 동안 심리가 얼마나 유지되는지, 최신 강세 비율, 탐욕형 감정을 종합합니다. 50 정도가 일반적이며, 자산을 자체 이력과 비교해 보세요.
/fear-greed-index
공포와 탐욕 지수
하나의 자산에 대한 일별 0–100 공포 대 탐욕 지표로, 가격, 변동성, 모멘텀, 거래량, 소셜 심리를 결합합니다: 최대 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, 80 초과 Extreme Greed입니다. metadata에 구성 요소가 나열됩니다.
/price-levels
소셜 언급 가격대
사람들이 자산에 대해 언급하는 가격(목표가, 지지선, 호가 수준)을 가격과 시간별로 묶은 것으로, 군중이 기대를 어디에 고정하고 있는지 보여줍니다. mentions는 언급된 가격 수준을 세므로 게시물 하나가 여러 개를 추가할 수 있습니다.
/social-volume-index
소셜 대비 거래량
자산에 대해 거래와 대화 중 어느 쪽이 더 활발한지를 각각 자체 90일 평균과 비교한 값입니다. volume_index는 0–100으로, 50이면 둘 다 같은 정도로 활발하고, 50을 넘으면 거래가 대화보다 앞서며, 50 미만이면 대화가 거래보다 앞섭니다. 최대 90일까지 일별로 제공됩니다.
/social-volume-profile
소셜 거래량 프로필
거래 대신 게시물로 구성된 거래량 프로파일로, 가격 축에서 자산에 대한 대화가 어디에서 일어났는지를 보여줍니다. 각 구간에는 게시물 수, 강세 및 약세 비중, 그리고 −1(전부 약세)에서 +1(전부 강세)까지의 directional_imbalance가 있습니다. significance_score는 게시물 수, 균형, 가격이 해당 구간을 다시 찾는 빈도, 압축을 기준으로 구간의 순위를 0에서 1로 매기며, 통제점은 가장 활발한 구간입니다. 하나의 그룹을 프로파일링하려면 clusters를 보내세요.
시장 데이터
엔드포인트 1개인텔리전스
엔드포인트 3개/calendar-events
캘린더 이벤트
예정 및 과거 시장 이벤트(실적 발표, 경제 지표 발표, IPO, 상장, 투표, 청문회)를 전 세계 또는 특정 자산이나 주제에 대해 조회합니다. 유형, 상태, 1~3의 중요도, 관련 엔티티를 포함합니다. 기본값은 오늘 이후이며 가장 이른 것부터 정렬됩니다. 주목할 만한 이벤트만 보려면 min_importance_score=2를 보내세요.
/insights
인텔리전스
시장 전반 또는 특정 자산이나 주체에 대해 무슨 일이 일어나고 있는지 다루는 짧은 스토리로, 각각 헤드라인, 요약, 감성(−1, 0, +1), 태그, 1에서 3까지의 중요도, 관련 엔티티를 포함합니다. 최근 업데이트순으로 정렬되며, 최신 이벤트를 먼저 보려면 order_by=start_time_desc를 보내세요.
/insights/attention
인사이트 주목도
하나의 인텔리전스 항목을 둘러싼 대화: 24시간 관심 창, 작성자 및 감성 집계, 시간별 버킷, 클러스터 구성, 임팩트 벡터, 그리고 가격을 산정할 수 있는 연결 엔터티 각각의 가격 반응을 제공합니다. 독자가 하나의 항목을 열어 드로어 수준의 전체 맥락이 필요할 때 /insights 이후에 사용하세요.
클러스터
엔드포인트 10개/clusters
작성자 클러스터
한 시장에서 모든 작성자 클러스터의 활동과 감성: 게시물, 고유 작성자, 이전 창 대비 변화, 그리고 시간별 시계열을 포함한 순 감성(강세 게시물에서 약세 게시물을 뺀 값)입니다. asset_class은 equity(기본값) 또는 crypto입니다.
/clusters/comparison
클러스터 비교
창 동안 모든 작성자 클러스터를 나란히 비교: 게시물과 그 변화, 시장 대비 강세 정도(cluster_bullish_share 대 market_bullish_share), 지난 7일 동안 가장 많이 전환한 자산(trending_asset), 그리고 일별 게시물입니다.
/clusters/comparison/divisive-assets
논쟁적인 자산
클러스터들이 가장 크게 의견이 갈리는, 널리 논의된 자산입니다. minority_share은 명확히 강세 또는 약세로 기우는 클러스터 중 더 작은 진영의 비율이므로, 0.5는 반반으로 나뉜 것입니다. 이는 다가올 움직임이 아니라 분열된 대화를 측정합니다.
/clusters/comparison/hype-cycles
하이프 사이클 도달
윈도우의 가장 큰 하이프 사이클과 각 사이클에 클러스터가 도착한 순서를 시장의 피크 시간을 기준으로 나타내며, 피크 전후의 시장 시간당 게시물도 함께 제공합니다.
/clusters/comparison/traits
클러스터 특성 비교
모든 클러스터의 /clusters/profile 특성을 가장 높은 순서로 나열하여, 각 특성에서 어떤 그룹이 앞서거나 뒤처지는지 확인합니다.
/clusters/hype-cycles
클러스터 하이프 사이클
한 클러스터가 시장보다 하이프 사이클에 얼마나 일찍 도착하는지를 나타냅니다. curve은 피크 7일 전부터 7일 후까지 각 진영 게시물의 누적 비율이므로 선이 왼쪽에 있을수록 더 이릅니다. lead_days는 클러스터의 리드(양수면 이름)이고, clusters는 모든 클러스터의 리드를 순위로 매깁니다.
/clusters/overlap
클러스터 중첩
이 클러스터와 같은 자산을 지켜보는 클러스터와 그 동의 여부를 나타냅니다. overlap_share은 상위 50개 자산 중 피어가 공유하는 비율이고, direction_agreement_share는 같은 방향으로 기우는 빈도이며, stance_gap는 이 클러스터가 더 강세일 때 양수입니다.
/clusters/profile
클러스터 프로필
한 클러스터의 행동 트레이트로, 각각 다른 모든 클러스터와 비교해 순위가 매겨집니다(rank 1이 가장 높음):
/clusters/rotation
클러스터 로테이션
한 클러스터의 관심이 어디로 이동하는지 보여줍니다. 이전 기간 대비 게시물 점유율이 늘어난 자산과 줄어든 자산을 베이시스 포인트로 나타내고, 게시물이 시장, 인물, 이벤트에 어떻게 나뉘는지도 보여줍니다.
/clusters/stances
클러스터 입장
가장 많이 논의된 자산에 대한 한 클러스터의 입장을 시장의 입장과 나란히 보여줍니다. −1(전부 약세)부터 +1(전부 강세)까지이며, contrarian_share는 시장과 반대 방향으로 기우는 빈도로, 다른 클러스터의 평균과 비교할 수 있습니다.