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

스크리너

GET /screener
스크리너

하나의 24시간 지표로 자산 또는 주제의 순위를 매기고 나머지 지표로 필터링합니다: share, share change, posts, net bullish posts(강세에서 약세를 뺀 값, 음수는 약세), 또는 24-hour price change. 범위는 양 끝값을 포함하며 서로 결합되고, 가격 필터는 자산에만 적용됩니다.

비중은 동일한 시장(주식, 크립토, 또는 인물과 토픽)에서 같은 24시간 동안 작성된 전체 게시물 중 해당 항목이 차지하는 비율이며 봇은 제외됩니다. clusters를 사용하면 해당 클러스터가 게시한 글 중에서의 비중을 의미합니다.

파라미터 규칙:

  • asset_class는 kind=asset에만 적용됩니다.
  • wallstreetbets와 같은 게시 커뮤니티는 asset_class가 equity, commodity 또는 index인 kind=asset에만 허용됩니다.
  • 각 최솟값은 해당 최댓값을 초과할 수 없습니다.
  • 가격 정렬과 가격 범위에는 kind=asset이 필요합니다.

https://nebula-api.hiddensystems.ai/api/v1/x402/screener에서 월렛 결제를 사용할 수 있습니다. Nebula 계정이나 API 키가 필요하지 않으며, 서명하기 전에 결제 제안을 확인하세요. x402 결제 가이드.

파라미터

kind string QUERY

순위를 매길 대상: asset(주식, 원자재, 지수 또는 크립토) 또는 subject(인물, 계정 및 토픽). 기본값은 asset입니다.

허용 값
assetsubject

Default:asset

asset_class string QUERY

kind=asset인 경우 순위를 매길 시장: equity(기본값), commodity, index 또는 crypto.

허용 값
equitycommodityindexcrypto

Default:equity

clusters array<string> QUERY

읽을 작성자 클러스터로, 반복해서 지정하면 결합됩니다(예: clusters=kols&clusters=media). 선택한 클러스터는 합산되며, 한 작성자가 여러 클러스터에 속할 수 있습니다.

  • Callers: smart_money(성과가 가장 좋은 콜러), dumb_money(성과가 가장 나쁜 콜러), top_degens(소형주 크립토에서 가장 우수한 콜러)
  • Timing: early_movers(관심이 높아질 때 자산에 대해 가장 먼저 언급), late_movers(정점이나 그 이후에 진입)
  • 빌더: developers, founders, team_leaders, project_accounts
  • 기관: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • 인플루언스: kols, celebrities, media, marketer, shiller
  • 애널리스트: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • 트레이더: position_trader, swing_trader, day_trader
  • 바이어스: perma_bull, doomer, tribalist
  • 기타: political, nft, bots, automated_ai
  • 게시 위치에 따른 커뮤니티: wallstreetbets, reddit

Example:smart_money

sort string QUERY

순위를 매길 기준 지표입니다. 기본값은 share입니다.

허용 값
shareshare_changeshare_change_pctpostsnet_bullish_postsprice_change_24h_pct

Default:share

order string QUERY

desc(기본값)는 가장 높은 값을 먼저 배치하고, asc는 가장 낮은 값을 먼저 배치합니다.

허용 값
descasc

Default:desc

limit integer QUERY

반환되는 최대 결과 수.

Default:25

min_share number QUERY

대화에서 차지하는 비중이 최소 이 비율 이상인 결과를 유지합니다. 값의 범위는 0에서 1입니다.

Example:1

max_share number QUERY

대화에서 차지하는 비중이 최대 이 비율 이하인 결과를 유지합니다. 값의 범위는 0에서 1입니다.

Example:1

min_share_change number QUERY

이전 24시간 대비 비중이 최소 이만큼 상승한 결과를 유지합니다. -1에서 1 사이의 비율로, 0.01은 1퍼센트 포인트입니다.

Example:1

max_share_change number QUERY

비중이 최대 이만큼 변화한 결과를 유지합니다. -1에서 1 사이의 비율이며, 음수 값은 비중을 잃은 결과를 선택합니다.

Example:1

min_posts integer QUERY

24시간 동안 게시물이 최소 이 개수 이상인 결과를 유지합니다. price_change_24h_pct로 정렬할 때 기본값은 5입니다.

Example:1

min_net_bullish_posts integer QUERY

약세 게시물보다 강세 게시물이 최소 이만큼 더 많은 결과를 유지합니다. 음수 값은 약세 결과를 허용합니다.

Example:1

max_net_bullish_posts integer QUERY

약세 게시물보다 강세 게시물이 최대 이만큼 더 많은 결과를 유지합니다. 음수 값은 약세 결과를 선택합니다.

Example:1

min_price_change_24h_pct number QUERY

24시간 가격 변동이 최소 이 퍼센트 이상인 자산을 유지합니다.

Example:1

max_price_change_24h_pct number QUERY

24시간 가격 변동이 최대 이 퍼센트 이하인 자산을 유지합니다.

Example:1

cURL 예제

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

응답

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

미디어 타입 application/json

asset_class
string 선택 사항

자산 순위가 매겨진 시장입니다. subject에는 없습니다.

clusters
array<string> 필수

게시물이 집계된 작성자 클러스터이며, 정규화된 값입니다. 봇을 제외한 모든 작성자가 집계된 경우 비어 있습니다.

from
string (date-time) 필수

순위가 매겨진 24시간의 UTC 시작 시각입니다. 비교 기간은 그 직전 24시간입니다.

kind
string 필수

순위가 매겨진 대상: 요청한 대로 asset 또는 subject입니다.

허용 값
assetsubject
previous_total_posts
integer (int64) 필수

지난 24시간 동안 순위가 매겨진 모집단의 모든 게시물입니다.

results
array<object> 필수

순위가 매겨진 결과이며, 가장 높은 순위부터 정렬됩니다.
results[].asset_class
string 선택 사항

자산의 클래스입니다: equity(주식 및 ETF), commodity, index, crypto 중 하나입니다. asset 범위의 모든 요청에 asset_id와 함께 보내세요.

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

공개 자산의 정규 식별자입니다: 주식, 상품, 지수의 경우 티커 또는 시장 심볼이고, crypto의 경우 CoinGecko 슬러그(슬러그가 없으면 숫자 id)입니다.

results[].bearish_posts
integer (int64) 필수

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

results[].bullish_posts
integer (int64) 필수

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

results[].kind
string 필수

결과의 유형입니다: asset(asset_id와 asset_class로 조회) 또는 subject(subject_id로 조회)입니다.

허용 값
assetsubject
results[].name
string 필수

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

results[].neutral_posts
integer (int64) 필수

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

results[].posts
integer (int64) 필수

순위가 매겨진 24시간 동안 이 결과의 게시물입니다.

results[].previous_posts
integer (int64) 필수

길이가 같은 바로 직전 기간에 이 결과의 게시물입니다.

results[].price_change_24h_pct
number (double) 선택 사항

24시간 동안의 원시 시장 가격 변동이며, 퍼센트 포인트 단위입니다.

results[].share
number (double) 필수

같은 24시간 동안 순위가 매겨진 모집단의 전체 게시물 중 이 결과의 게시물 비율이며, 0에서 1 사이입니다.

results[].share_change
number (double) 선택 사항

이전 기간 대비 점유율 변화이며, 소수 비율로 표시됩니다: 0.01은 1퍼센트 포인트입니다. 모집단에 이전 기간의 게시물이 없을 때만 없습니다.

results[].share_change_pct
number (double) 선택 사항

이전 기간의 점유율 대비 점유율 변화이며, 퍼센트 단위입니다. 이 결과에 이전 기간의 게시물이 없으면 없습니다.

results[].subject_id
string 선택 사항

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

results[].symbol
string 선택 사항

표시용 티커 또는 시장 심볼입니다.

to
string (date-time) 필수

순위가 매겨진 24시간의 UTC 종료 시각입니다: 순위가 계산된 시점입니다.

total_posts
integer (int64) 필수

24시간 동안 순위가 매겨진 모집단의 모든 게시물입니다: 점유율의 분모입니다.

{
  "asset_class": "equity",
  "clusters": [],
  "from": "2026-08-06T15:00:00Z",
  "kind": "asset",
  "previous_total_posts": 17205,
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "bearish_posts": 61,
      "bullish_posts": 214,
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "neutral_posts": 111,
      "posts": 386,
      "previous_posts": 273,
      "price_change_24h_pct": -2.48,
      "share": 0.025255,
      "share_change": 0.009388,
      "share_change_pct": 59.16,
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "bearish_posts": 30,
      "bullish_posts": 92,
      "kind": "asset",
      "name": "Amazon.com, Inc.",
      "neutral_posts": 63,
      "posts": 185,
      "previous_posts": 165,
      "price_change_24h_pct": -0.32,
      "share": 0.012104,
      "share_change": 0.002516,
      "share_change_pct": 26.24,
      "symbol": "AMZN"
    }
  ],
  "to": "2026-08-07T15:00:00Z",
  "total_posts": 15284
}