Duygu Durumu

GET /sentiment
GetSentiment

Bir varlık, konu veya tüm piyasa hakkındaki konuşmanın zaman içinde ne kadar boğa veya ayı olduğu. sentiment_signal, son 24 saatteki boğa eksi ayı gönderi sayısıdır ve son gönderiler daha fazla ağırlıklandırılır: pozitif değer net boğadır. Hacimle birlikte büyür, bu nedenle bir varlığı kendi geçmişiyle karşılaştırın.

cohorts, botlar ve tek bir varlık veya konu için en iyi çağrı yapanlar için aynı ölçümü verir. Bir veya daha fazla yazar grubunu okumak için clusters gönderin ya da piyasa geneli bir görünüm için varlığı ve konuyu atlayın.

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/sentiment 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

Okunacak yazar kümeleri; birleştirmek için tekrarlayın, örneğin clusters=kols&clusters=media. Seçilen kümeler toplanır ve bir yazar birden fazla kümeye ait olabilir.

  • Callers: smart_money (en iyi performans gösteren çağrıcılar), dumb_money (en kötü performans gösterenler), top_degens (küçük ölçekli kriptoda en iyiler)
  • Timing: early_movers (dikkat artarken bir varlık hakkında ilk konuşanlar), late_movers (zirvede veya sonrasında gelenler)
  • Geliştiriciler: developers, founders, team_leaders, project_accounts
  • Kurumlar: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Etki: kols, celebrities, media, marketer, shiller
  • Analistler: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Trader'lar: position_trader, swing_trader, day_trader
  • Eğilim: perma_bull, doomer, tribalist
  • Diğer: political, nft, bots, automated_ai
  • Gönderinin yapıldığı yere göre topluluklar: wallstreetbets, reddit

Example:smart_money

cURL Örneği

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

cohorts
object zorunlu

Diğer yazar grupları için aynı ölçüm: bots ve bu popülasyon mevcut olduğunda top_callers. Bot olmayan popülasyon series'in kendisidir.

İzin verilen anahtarlar
botstop_callers
cohorts.{key}[].bearish_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki ayı gönderileri; interval_bearish_posts kovanın kendisidir.

cohorts.{key}[].bullish_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki boğa gönderileri; interval_bullish_posts kovanın kendisidir.

cohorts.{key}[].interval_bearish_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki ayı gönderileri.

cohorts.{key}[].interval_bullish_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki boğa gönderileri.

cohorts.{key}[].interval_neutral_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki nötr gönderiler.

cohorts.{key}[].interval_posts
number (double) isteğe bağlı

Geriye dönük birikimden önce, bu yayımlanan zaman kovasındaki gönderiler.

cohorts.{key}[].neutral_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki nötr gönderiler; interval_neutral_posts kovanın kendisidir.

cohorts.{key}[].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.

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

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

cohorts.{key}[].total_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki gönderiler, yalnızca bu kova değil; interval_posts kovanın kendisidir.

series
array<object> zorunlu

Kronolojik olarak sıralanmış gözlemler.

series[].bearish_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki ayı gönderileri; interval_bearish_posts kovanın kendisidir.

series[].bullish_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki boğa gönderileri; interval_bullish_posts kovanın kendisidir.

series[].interval_bearish_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki ayı gönderileri.

series[].interval_bullish_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki boğa gönderileri.

series[].interval_neutral_posts
number (double) isteğe bağlı

Bu yayımlanan zaman kovasındaki nötr gönderiler.

series[].interval_posts
number (double) isteğe bağlı

Geriye dönük birikimden önce, bu yayımlanan zaman kovasındaki gönderiler.

series[].neutral_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki nötr gönderiler; interval_neutral_posts kovanın kendisidir.

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.

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

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

series[].total_posts
number (double) zorunlu

Bu noktada sona eren son 24 saatteki gönderiler, yalnızca bu kova değil; interval_posts kovanın kendisidir.

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}