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

Küme hype döngüleri

GET /clusters/hype-cycles
GetClusterHypeCycles

Bir kümenin hype döngülerine piyasaya kıyasla ne kadar erken ulaştığı. curve, her tarafın gönderilerinin bir zirveden 7 gün öncesinden 7 gün sonrasına kadarki kümülatif payıdır; yani çizgi ne kadar soldaysa o kadar erkendir; lead_days kümenin öncülüğüdür (pozitif değer erkendir) ve clusters her kümenin öncülüğünü sıralar.

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/hype-cycles 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

days integer QUERY

En son tamamlanan günden geriye doğru sayarak kaç tam UTC günü piyasa zirvesinin dahil edileceği: 30 veya 90. Ücretsiz planlar 90 güne kadar erişebilir; daha fazlası 403 döndürür.

İzin verilen değerler
3090

Default:90

cURL Örneği

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

clusters
array<object> zorunlu

Öncülüğü olan her küme (5 veya daha fazla döngü), en erken önce, istenen küme dahil.
clusters[].cluster_id
string zorunlu

Küme, kanonik cluster_id değeri olarak.

clusters[].cycles_joined
integer zorunlu

Kümenin piyasanın zirve saatinden sonraki 24 saat içinde gönderi paylaştığı tamamlanmış hype döngüleri.

clusters[].lead_days
number (double) zorunlu

Kümenin gün cinsinden öncülüğü, üst düzey lead_days olarak hesaplanır. Pozitif değer erkendir.

clusters[].lead_high_days
number (double) zorunlu

Olası lead_days aralığının üst ucu.

clusters[].lead_low_days
number (double) zorunlu

Olası lead_days aralığının alt ucu.

curve
array<object> zorunlu

Ortalama kümülatif birikim, day_offset −7 ile +7 arasında her gün için bir nokta; hiçbir döngü tamamlanmadığında boştur.
curve[].cluster_cumulative_pct
number (double) zorunlu

Kümenin zirve çevresindeki 15 gündeki gönderilerinin bu günün sonuna kadar yapılan yüzdesi, döngüler üzerinden ortalanmış; day_offset 7'de 100.

curve[].day_offset
integer zorunlu

Piyasa zirvesinden itibaren gün sayısı: zirveden önce negatif, zirve gününde 0, sonrasında pozitif.

curve[].market_cumulative_pct
number (double) zorunlu

Aynısı piyasa için, aynı döngüler üzerinden.

cycles_joined
integer zorunlu

Kümenin katıldığı tamamlanmış hype döngüleri: zirveden sonraki 7 gün içinde 3 veya daha fazla gönderi.

days
integer zorunlu

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

lead_days
number (double) zorunlu

Kümenin gönderilerinin piyasanın zirve saatinden sonraki 24 saat içinde diğer herkesten ne kadar önde geldiği, gün cinsinden. Pozitif değer erkendir; 20 döngünün altında null.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "clusters": [
    {
      "cluster_id": "wallstreetbets",
      "cycles_joined": 171,
      "lead_days": 0.0542,
      "lead_high_days": 0.0708,
      "lead_low_days": 0.0417
    },
    {
      "cluster_id": "smart_money",
      "cycles_joined": 471,
      "lead_days": 0.0125,
      "lead_high_days": 0.0292,
      "lead_low_days": -0.0083
    },
    {
      "cluster_id": "exchanges",
      "cycles_joined": 466,
      "lead_days": -0.0667,
      "lead_high_days": -0.0542,
      "lead_low_days": -0.0792
    }
  ],
  "curve": [
    {
      "cluster_cumulative_pct": 46.8,
      "day_offset": -1,
      "market_cumulative_pct": 38.2
    },
    {
      "cluster_cumulative_pct": 63.5,
      "day_offset": 0,
      "market_cumulative_pct": 57.9
    },
    {
      "cluster_cumulative_pct": 73.1,
      "day_offset": 1,
      "market_cumulative_pct": 69.4
    }
  ],
  "cycles_joined": 27,
  "days": 90,
  "lead_days": 0.0125
}