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

Yazar kümeleri

GET /clusters
ListClusters

Bir piyasada her yazar kümesinin etkinliği ve duygusu: gönderiler, benzersiz yazarlar, önceki pencereye göre değişim ve saatlik seriyle birlikte net duygu (boğa eksi ayı gönderileri). asset_class equity (varsayılan) veya crypto'dur.

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

Parametreler

asset_class string QUERY

Toplanacak piyasa: equity (hisse senetleri, emtialar ve endeksleri birlikte kapsayan geleneksel piyasalar) veya crypto.

İzin verilen değerler
equitycrypto

Default:equity

hours integer QUERY

Saat cinsinden geriye dönük pencere. Ücretsiz planlar 90 güne kadar erişebilir; daha fazlası 403 döndürür.

Default:24

cURL Örneği

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

clusters
array<object> zorunlu

Seçilen varlık sınıfı için yazar kümesi özetleri.
clusters[].activity_change_pct
number (double) isteğe bağlı

Ö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
number (double) zorunlu

Bearish olarak sınıflandırılan gönderiler.

clusters[].bullish_posts
number (double) zorunlu

Bullish olarak sınıflandırılan gönderiler.

clusters[].cluster_id
string zorunlu

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

clusters[].neutral_posts
number (double) zorunlu

Neutral olarak sınıflandırılan gönderiler.

clusters[].previous_total_posts
number (double) zorunlu

Hemen önceki eşit uzunluktaki penceredeki gönderi sayısı.

clusters[].recent_sentiment_signal
number (double) zorunlu

Saatlik duygu serisinin en son değeri: gönderi içeren en son saat.

clusters[].series
array<object> zorunlu

Kronolojik olarak sıralanmış gözlemler.
clusters[].series[].bearish_posts
number (double) zorunlu

Bearish olarak sınıflandırılan gönderiler.

clusters[].series[].bullish_posts
number (double) zorunlu

Bullish olarak sınıflandırılan gönderiler.

clusters[].series[].sentiment_signal
number (double) zorunlu

Azalma ağırlıklı net boğa gönderileri: boğa eksi ayı. Pozitif boğa, negatif ayıdır ve büyüklük etkinlikle birlikte artar.

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

Gözlem veya kova başlangıcı için UTC RFC 3339 zaman damgası.

clusters[].series[].total_posts
number (double) zorunlu

Metriğin etkin inceleme penceresindeki gönderi sayısı.

clusters[].total_posts
number (double) zorunlu

Metriğin etkin inceleme penceresindeki gönderi sayısı.

clusters[].window_sentiment_signal
number (double) zorunlu

İstenen tam pencere boyunca net boğa duygu sinyali.

hours
integer zorunlu

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

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}