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

REST API
클러스터

클러스터 중첩

GET /clusters/overlap

GetClusterOverlap

이 클러스터와 같은 자산을 지켜보는 클러스터와 그 동의 여부를 나타냅니다. overlap_share은 상위 50개 자산 중 피어가 공유하는 비율이고, direction_agreement_share는 같은 방향으로 기우는 빈도이며, stance_gap는 이 클러스터가 더 강세일 때 양수입니다.

파라미터 규칙:

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

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

cURL 예제

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/overlap' \
  --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를 생략한 경우에는 네 가지 모두입니다.

cluster_id

string 필수

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

days

integer 필수

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

peers

array<object> 필수

다른 모든 활성 클러스터를 중복이 가장 많은 순서로 나열합니다.

peers[].agreeing_asset_count

integer 필수

두 클러스터가 시장 대비 같은 방향으로 기우는 비교 대상 자산입니다.

peers[].cluster_id

string 필수

정규 작성자 클러스터 식별자입니다.

peers[].compared_asset_count

integer 필수

전체 중복 범위에서 두 클러스터 모두 시장의 입장과 0.05 이상 차이 나게 기우는 공유 자산입니다.

peers[].direction_agreement_share

number (double) 필수

두 클러스터 모두 시장의 입장과 0.05 이상 차이 나게 기우는 공유 자산 중 같은 방향으로 기우는 비율: agreeing_asset_count ÷ compared_asset_count. 자산 3개 미만이면 null입니다.

peers[].overlap_share

number (double) 필수

이 클러스터의 집중 세트 중 피어의 집중 세트에도 포함된 비율로, 0에서 1까지입니다.

peers[].shared_assets

array<object> 필수

두 집중 세트 모두에 있는 최대 5개 자산을 이 클러스터의 관심 순서로 나열합니다.

peers[].shared_assets[].asset_class

string 필수

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

허용 값

equitycommodityindexcrypto

peers[].shared_assets[].asset_id

string 필수

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

peers[].shared_assets[].cluster_stance

number (double) 필수

해당 자산에 대한 이 클러스터의 순 입장으로, −1에서 +1까지입니다. 강세 또는 약세 게시물이 3개 미만이면 null입니다.

peers[].shared_assets[].market_stance

number (double) 필수

해당 자산에 대한 시장의 순 입장으로, −1에서 +1까지입니다. 두 기울기를 측정하는 기준선입니다. 강세 또는 약세 게시물이 3개 미만이면 null입니다.

peers[].shared_assets[].name

string 필수

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

peers[].shared_assets[].peer_stance

number (double) 필수

해당 자산에 대한 피어의 순 입장으로, −1에서 +1까지입니다. 강세 또는 약세 게시물이 3개 미만이면 null입니다.

peers[].shared_assets[].symbol

string 필수

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

peers[].stance_gap

number (double) 필수

이 클러스터의 입장에서 피어의 입장을 뺀 값으로, 두 클러스터 모두 입장이 있는 공유 자산에 대해 평균한 값이며 −2에서 +2까지입니다. 양수면 이 클러스터가 더 강세입니다. 자산 3개 미만이면 null입니다.

top_asset_count

integer 필수

각 클러스터의 집중 세트 크기로, 가장 많이 논의된 자산을 이 개수까지 포함합니다.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}