전체 문서 Nebula 문서 모든 엔드포인트 인터랙티브 문서 Markdown OpenAPI JSON

REST API
클러스터

클러스터 입장

GET /clusters/stances

GetClusterStances

가장 많이 논의된 자산에 대한 한 클러스터의 입장을 시장의 입장과 나란히 보여줍니다. −1(전부 약세)부터 +1(전부 강세)까지이며, contrarian_share는 시장과 반대 방향으로 기우는 빈도로, 다른 클러스터의 평균과 비교할 수 있습니다.

파라미터 규칙:

cluster_id을 전송합니다.
cluster_id은 클러스터 하나를 지정합니다. 여러 클러스터를 비교하려면 클러스터마다 한 번씩 호출하거나, /clusters를 사용해 모든 클러스터를 한 번에 가져오세요.
게시 커뮤니티(wallstreetbets, reddit)는 주식만 다룹니다. 둘 중 하나를 사용할 경우 asset_class에 equity이 포함되어야 합니다.

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

파라미터

cluster_id string QUERY 필수

분석할 클러스터로, /clusters가 반환하는 형식입니다. 예를 들어 smart_money 또는 wallstreetbets입니다. /sentiment의 clusters 파라미터에서 가져온 모든 id를 사용할 수 있습니다.

Example:smart_money

asset_class array<string> QUERY

분석할 시장으로, equity, commodity, index, crypto 중 하나 이상을 쉼표로 구분해 지정합니다. 기본값은 네 가지 모두입니다. 여러 개를 쉼표로 구분해 전송하세요.

Default:equity,commodity,index,crypto

days integer QUERY

가장 최근의 완전한 일자부터 거슬러 세어, 입장을 측정할 완전한 UTC 일자 수: 7, 30 또는 90. 무료 플랜은 90일까지 조회할 수 있으며, 그 이상은 403을 반환합니다.

허용 값

73090

Default:30

limit integer QUERY

반환되는 최대 자산 수입니다.

Default:30

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/stances' \
  --data-urlencode 'cluster_id=smart_money' \
  --header 'X-API-Key: YOUR_API_KEY'

응답

200 OK

400 잘못된 요청

401 인증되지 않음

402 크레딧이 모두 소진됨. 응답에 갱신 시점과 구매한 크레딧 잔액이 포함됩니다.

403 금지됨

404 찾을 수 없음

405 허용되지 않은 메서드입니다. Allow 헤더에 지원되는 메서드가 나열됩니다.

429 요청이 너무 많음

500 내부 서버 오류

503 서비스 이용 불가

미디어 타입 application/json

asset_classes

array<string> 필수

분석된 시장으로, equity, commodity, index, crypto 순서입니다. 요청한 asset_class 값이며, asset_class를 생략한 경우에는 네 가지 모두입니다.

assets

array<object> 필수

클러스터에서 가장 많이 논의된 적격 자산(클러스터 게시물 3개 이상, 시장 게시물 20개 이상)으로, 최대 limit개까지입니다.

assets[].asset_class

string 필수

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

허용 값

equitycommodityindexcrypto

assets[].asset_id

string 필수

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

assets[].cluster_posts

integer (int64) 필수

해당 기간에 자산에 대한 클러스터의 게시물 수.

assets[].cluster_stance

number (double) 필수

해당 기간에 자산에 대한 클러스터의 순 입장: (강세 − 약세) / (강세 + 약세) 게시물로, −1(전부 약세)부터 +1(전부 강세)까지입니다.

assets[].market_stance

number (double) 필수

같은 윈도우 동안 같은 자산에 대한 시장의 순 입장으로, 같은 −1에서 +1 척도이며, 봇을 제외한 모든 작성자의 게시물을 사용합니다.

assets[].name

string 필수

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

assets[].symbol

string 필수

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

cluster_id

string 필수

분석된 클러스터로, 정규 cluster_id로 표시됩니다.

contrarian_share

number (double) 필수

클러스터와 시장이 서로 반대 방향으로 기우는 적격 자산의 비중(둘 다 중립에서 최소 0.1 이상 벗어난 경우). 자산이 5개 미만이면 null.

days

integer 필수

가장 최근의 완전한 일자에서 끝나는, 완전한 UTC 일자 단위의 윈도우 길이입니다.

peer_average_contrarian_share

number (double) 필수

다른 클러스터에 대해 평균한 contrarian_share이며, 값이 있는 클러스터가 없으면 null.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}