Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON
  1. REST API
  2. Kümeler

Küme rotasyonu

GET /clusters/rotation
GetClusterRotation

Bir kümenin dikkatinin nereye kaydığı: önceki pencereye kıyasla gönderilerinden pay kazanan ve kaybeden varlıklar, baz puan cinsinden ve gönderilerinin piyasalar, kişiler ve olaylar arasında nasıl bölündüğü.

Parametre kuralları:

  • cluster_id gönderin.
  • cluster_id tek bir kümeyi adlandırır; birkaçını karşılaştırmak için her küme için bir kez çağırın veya tüm kümeler için tek seferde /clusters kullanın.
  • Gönderi toplulukları (wallstreetbets, reddit) yalnızca hisse senetlerini kapsar: bunlardan biriyle asset_class mutlaka equity içermelidir.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/rotation adresinde kullanılabilir. Nebula hesabı veya API anahtarı gerekmez; imzalamadan önce ödeme teklifini kontrol edin. x402 ödeme kılavuzu.

Parametreler

cluster_id string QUERY zorunlu

Analiz edilecek küme, /clusters tarafından döndürüldüğü biçimde, örneğin smart_money veya wallstreetbets. /sentiment parametresinin clusters değerinden alınan herhangi bir id.

Example:smart_money

asset_class array<string> QUERY

Analiz edilecek piyasalar: equity, commodity, index ve crypto değerlerinden herhangi biri, virgülle ayrılmış. Varsayılan olarak dördü de kullanılır. Birden fazlasını virgülle ayırarak gönderin.

Default:equity,commodity,index,crypto

hours integer QUERY

Kendisiyle aynı uzunluktaki önceki pencereyle karşılaştırılacak pencere: 24 (son 24 saat), 168 (son 7 tam gün) veya 720 (son 30 tam gün). Ücretsiz planlar 90 gün geriye gider; daha fazlası 403 döndürür.

İzin verilen değerler
24168720

Default:168

limit integer QUERY

Döndürülen en fazla yükselen sayısı ve ayrı olarak en fazla düşen sayısı.

Default:6

cURL Örneği

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

Yanıtlar

200 OK
400 Hatalı İstek
401 Yetkisiz
402 Krediler tükendi; yanıt, yenileme zamanlamasını ve satın alınan kredi bakiyesini içerir
403 Yasak
404 Bulunamadı
405 Yönteme izin verilmiyor; Allow başlığı desteklenen yöntemi listeler
429 Çok Fazla İstek
500 Sunucu İçi Hata
503 Hizmet Kullanılamıyor

Medya türü application/json

asset_classes
array<string> zorunlu

Analiz edilen piyasalar, equity, commodity, index, crypto sırasıyla: istenen asset_class değerleri veya asset_class atlandığında dördü.

cluster_id
string zorunlu

Analiz edilen küme, kanonik cluster_id değeri olarak.

gainers
array<object> zorunlu

Kümenin gönderilerindeki payı en çok artan varlıklar, en büyük artış önce. Yalnızca payı artan varlıklar listelenir.
gainers[].asset_class
string zorunlu

Varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. Her asset kapsamlı istekte asset_id ile birlikte gönderin.

İzin verilen değerler
equitycommodityindexcrypto
gainers[].asset_id
string zorunlu

Kanonik genel varlık tanımlayıcısı: hisseler, emtialar ve endeksler için ticker veya piyasa sembolü, kripto için CoinGecko slug'ı (yoksa sayısal bir id).

gainers[].current_share
number (double) zorunlu

Geçerli pencerede seçilen varlık sınıfları hakkındaki tüm küme gönderilerine oranla gönderiler, 0 ile 1 arasında.

gainers[].name
string zorunlu

İnsan tarafından okunabilir ad.

gainers[].previous_share
number (double) zorunlu

Karşılaştırma penceresinde varlığın gönderilerinin tüm küme gönderilerine oranı, 0 ile 1 arasında.

gainers[].share_change_bps
integer zorunlu

current_share eksi karşılaştırma penceresindeki pay, baz puan cinsinden: 100 bir yüzde puanıdır. Negatif, payın düştüğü anlamına gelir.

gainers[].symbol
string zorunlu

Görünen ticker veya piyasa sembolü.

hours
integer zorunlu

Yanıtın temsil ettiği geriye dönük pencere, saat cinsinden.

losers
array<object> zorunlu

Kümenin gönderilerindeki payı en çok düşen varlıklar, en büyük düşüş önce. Yalnızca payı düşen varlıklar listelenir.
losers[].asset_class
string zorunlu

Varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. Her asset kapsamlı istekte asset_id ile birlikte gönderin.

İzin verilen değerler
equitycommodityindexcrypto
losers[].asset_id
string zorunlu

Kanonik genel varlık tanımlayıcısı: hisseler, emtialar ve endeksler için ticker veya piyasa sembolü, kripto için CoinGecko slug'ı (yoksa sayısal bir id).

losers[].current_share
number (double) zorunlu

Geçerli pencerede seçilen varlık sınıfları hakkındaki tüm küme gönderilerine oranla gönderiler, 0 ile 1 arasında.

losers[].name
string zorunlu

İnsan tarafından okunabilir ad.

losers[].previous_share
number (double) zorunlu

Karşılaştırma penceresinde varlığın gönderilerinin tüm küme gönderilerine oranı, 0 ile 1 arasında.

losers[].share_change_bps
integer zorunlu

current_share eksi karşılaştırma penceresindeki pay, baz puan cinsinden: 100 bir yüzde puanıdır. Negatif, payın düştüğü anlamına gelir.

losers[].symbol
string zorunlu

Görünen ticker veya piyasa sembolü.

topic_changes
array<object> zorunlu

Her konunun geçerli penceredeki payı ve öncekine kıyasla değişimi; sırasıyla equity, commodity, index, crypto, people, events.
topic_changes[].current_share
number (double) zorunlu

Konunun geçerli pencerede kümenin gönderilerindeki payı, 0 ile 1 arasında.

topic_changes[].share_change_bps
integer zorunlu

Önceki pencereye kıyasla pay değişimi, baz puan cinsinden (100 bir yüzde puanıdır).

topic_changes[].topic
string zorunlu

equity, commodity, index, crypto, people (kişiler ve hesapları) veya events (yerler, temalar ve olaylar).

İzin verilen değerler
equitycommodityindexcryptopeopleevents
topic_series
array<object> zorunlu

Her konunun tam UTC günü başına kümenin gönderilerindeki payı, en eskisi önce.
topic_series[].timestamp
string (date-time) zorunlu

Günün UTC başlangıcı: 00:00.

topic_series[].topics
array<object> zorunlu

Her konunun o gün kümenin gönderilerindeki payı, topic_changes sırasıyla. Küme o gün gönderi paylaştığında payların toplamı 1 eder.
topic_series[].topics[].topic
string zorunlu

equity, commodity, index, crypto, people (kişiler ve hesapları) veya events (yerler, temalar ve olaylar).

İzin verilen değerler
equitycommodityindexcryptopeopleevents
topic_series[].topics[].topic_share
number (double) zorunlu

Konunun o gün kümenin gönderilerindeki payı, 0 ile 1 arasında.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}