Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON
  1. REST API
  2. Sosyal & Duygu Durumu

Sosyal momentum

GET /social-momentum
GetSocialMomentum

Bir varlık, bir konu veya tüm bir piyasa için her yazar kümesindeki gönderiler, benzersiz göndericiler ve duygu durumu yan yana: hangi grupların konuşmayı yönlendirdiği ve tonlarının nasıl farklılaştığı. Kümeler örtüşür, bu yüzden bunları toplamayın. Yalnızca adını verdiklerinizi döndürmek için clusters gönderin.

Parametre kuralları:

  • asset_id ile asset_class birlikte gönderilmelidir.
  • subject_id, asset_id veya asset_class ile birleştirilemez.
  • asset_id olmadan asset_class, equity veya crypto olmalıdır; commodity ve index için bir asset_id gerekir.

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

Parametreler

asset_id string QUERY

/assets veya /search'ten alınan varlık ID'si; örneğin NVDA, GLD, SPX veya bitcoin. Yanında döndürülen asset_class ile birlikte gönderin.

Example:NVDA

asset_class string QUERY

asset_id ile birlikte varlığın sınıfı. Onsuz, toplanacak piyasa: equity (hisseler, emtialar ve endeksler; varsayılan) veya crypto.

İzin verilen değerler
equitycommodityindexcrypto

Example:equity

subject_id string QUERY

/subjects veya /search tarafından döndürülen kanonik varlık dışı tanımlayıcı, örneğin text:jensen huang veya handle:elonmusk. Her durumda kabul edilir. asset_id veya asset_class ile birleştirilemez.

Example:text:jensen huang

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:168

granularity string QUERY

İstenen zaman serisi kova boyutu. Atlanırsa, hizmet geriye dönük pencereye uygun bir kova boyutu seçer.

İzin verilen değerler
1h2h4h12h1d

Example:1h

clusters array<string> QUERY

Yalnızca bu kümeler, her biri kendi serisi olarak; tümü için atlayın. Gönderi toplulukları hariç, /sentiment parametresinin clusters parametresindeki kimlikleri kullanır.

Example:smart_money

cURL Örneği

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

Kanonik yazar kümesi tanımlayıcısına göre anahtarlanmış sosyal momentum serisi.
clusters.{key}[].average_sentiment_score
number (double) zorunlu

Gönderilerin duygu puanlarının aritmetik ortalaması; −100 (çok düşüş yönlü) ile +100 (çok yükseliş yönlü) ölçeğinde.

clusters.{key}[].bearish_posts
integer (int64) zorunlu

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

clusters.{key}[].bullish_posts
integer (int64) zorunlu

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

clusters.{key}[].neutral_posts
integer (int64) zorunlu

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

clusters.{key}[].timestamp
string (date-time) zorunlu

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

clusters.{key}[].total_posts
integer (int64) zorunlu

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

clusters.{key}[].unique_posters
integer (int64) zorunlu

Kovadaki farklı gönderi hesapları; saatlikten daha kaba bir ayrıntı düzeyinde bu, saatlik sayımlardan toplanan bir üst sınırdır.

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}