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

마인드셰어

GET /mindshare
GetMindshare

자산 또는 주체가 대화에서 차지하는 비중: 해당 시장(주식, 암호화폐 또는 인물과 토픽)의 전체 게시물 중 최근 24시간 동안의 게시물 비율로, 0에서 1 사이입니다. 하나 이상의 작성자 그룹 내에서 비중을 측정하려면 clusters를 보내세요.

파라미터 규칙:

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

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

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

Example:smart_money

cURL 예제

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

series
array<object> 필수

시간순으로 정렬된 관측값입니다.
series[].share
number (double) 필수

대상이 되는 소셜 관심도의 비중으로, 0에서 1 사이의 소수 비율입니다.

series[].timestamp
string (date-time) 필수

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

{
  "series": [
    {
      "share": 0.148,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}