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

Küme karşılaştırması

GET /clusters/comparison
CompareClusters

Pencere boyunca her yazar kümesi yan yana: gönderiler ve değişimleri, piyasaya karşı ne kadar boğa olduğu (cluster_bullish_share - market_bullish_share), son 7 günde en çok yöneldiği varlık (trending_asset) ve günlük gönderiler.

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

Parametreler

asset_class array<string> QUERY

Karşılaştırılacak piyasalar: equity, commodity, index ve crypto'dan herhangi biri, virgülle ayrılmış. Varsayılan olarak dördü. Birden fazlasını virgülle ayrılmış olarak gönderin.

Default:equity,commodity,index,crypto

days integer QUERY

En son tam UTC gününden geriye sayarak kaç tam UTC günün karşılaştırılacağı: 7, 30 veya 90. activity_change_pct, aynı sayıda gün öncesiyle karşılaştırır. Ücretsiz planlar 90 gün geriye erişir; daha fazlası 403 döndürür.

İzin verilen değerler
73090

Default:30

cURL Örneği

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison' \
  --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ü.

clusters
array<object> zorunlu

Pencerede gönderisi olan her küme, en çok gönderi önce.
clusters[].activity_change_pct
number (double) zorunlu

Önceki eşit uzunluktaki pencereye göre gönderi yüzdesi değişimi (84'ten sonra 76 gönderi -9,52); karşılaştırma mümkün olmadığında yok.

clusters[].bearish_posts
integer (int64) zorunlu

Kümenin pencere boyunca ayı gönderileri.

clusters[].bullish_posts
integer (int64) zorunlu

Kümenin pencere boyunca boğa gönderileri.

clusters[].cluster_bullish_share
number (double) zorunlu

Kümenin pencere boyunca boğa ÷ (boğa + ayı) gönderileri, 0 ile 1 arasında. Boğa veya ayı gönderisi yoksa null.

clusters[].cluster_id
string zorunlu

Kanonik yazar kümesi tanımlayıcısı.

clusters[].market_bullish_share
number (double) zorunlu

Kümenin okuduğu piyasa için aynı pay, aynı günler ve varlık sınıfları boyunca (bir gönderi topluluğu için equity piyasası): temel cluster_bullish_share'in karşılaştırdığı değer. Boğa veya ayı gönderisi yoksa null.

clusters[].posts
integer (int64) zorunlu

Kümenin pencere boyunca gönderileri.

clusters[].series
array<object> zorunlu

Pencerenin her tam UTC günü, en eskiden başlayarak; gönderi olmayan günler dahil.
clusters[].series[].bearish_posts
integer (int64) zorunlu

Kümenin o günkü düşüş yönlü gönderileri.

clusters[].series[].bullish_posts
integer (int64) zorunlu

Kümenin o günkü yükseliş yönlü gönderileri.

clusters[].series[].posts
integer (int64) zorunlu

Kümenin o günkü gönderileri.

clusters[].series[].timestamp
string (date-time) zorunlu

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

clusters[].trending_asset
object zorunlu

Kümenin son 7 tam günde piyasadan daha fazla yöneldiği varlık; yoksa null.
clusters[].trending_asset.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
clusters[].trending_asset.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).

clusters[].trending_asset.name
string zorunlu

İnsan tarafından okunabilir ad.

clusters[].trending_asset.symbol
string zorunlu

Görünen ticker veya piyasa sembolü.

days
integer zorunlu

Pencere uzunluğu tam UTC günü cinsinden, en son tam günde sona erer.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}