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

Zaman dilimine göre duyarlılık

GET /sentiment/timeframes
GetSentimentTimeframes

İnsanların konuştuğu vadeye göre ayrılmış duygu: kısa vade (bir haftaya kadar), orta vade (haftalar ile aylar arası) ve uzun vade (üç ay veya daha fazlası); her biri /sentiment ölçeğinde. Bu hafta düşüş yönünde ama yıl genelinde yükseliş yönünde olan bir kalabalığı, baştan sona düşüş yönünde olan bir kalabalıktan ayırır.

Parametre kuralları:

  • asset_id veya subject_id gönderin.
  • asset_id ile asset_class birlikte gönderilmelidir.
  • subject_id, asset_id veya asset_class ile birleştirilemez.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes 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 adlandırılan varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. /assets veya /search'ün asset_id ile birlikte döndürdüğü asset_class'ı gönderin.

İ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:720

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

cURL Örneği

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment/timeframes' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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

current
object zorunlu

Mevcut her zaman dilimi vadesi için en güncel duygu okuması.

İzin verilen anahtarlar
short_termmedium_termlong_term
metadata
object isteğe bağlı

Yanıtı yorumlamak için gereken metodoloji ve istek penceresi üst verileri.
metadata.as_of
string (date-time) isteğe bağlı

Metriğin hesaplandığı UTC zamanı.

metadata.calculation
string isteğe bağlı

Hesaplama yöntemi için kısa ad.

metadata.formula
string isteğe bağlı

Hesaplama için insan tarafından okunabilir formül.

metadata.half_life_hours
number (double) isteğe bağlı

Adına rağmen, doğrusal azalma penceresinin saat cinsinden uzunluğu: bir gönderi yeniyken tam, orta noktada yarım sayılır ve bu kadar eski olduğunda hiç sayılmaz.

metadata.lookback_days
integer isteğe bağlı

Hesaplamanın kullandığı geçmişe dönük inceleme süresi, gün cinsinden.

metadata.scale
string isteğe bağlı

Metriğin yayımlanmış ölçeği veya yorumu.

series
object zorunlu

short_term, medium_term ve long_term vadesine göre anahtarlanmış duygu serisi.

İzin verilen anahtarlar
short_termmedium_termlong_term
series.{key}[].interval_posts
number (double) isteğe bağlı

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

series.{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.

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

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

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

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}