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

İlgili konular

GET /related-subjects
GetRelatedSubjects

Bir varlık veya konuyla aynı gönderilerde en sık birlikte anılan kişiler, hesaplar ve konular. share, paylaşılan gönderilerin çapa varlığın gönderilerine oranıdır; duygu alanları, bu paylaşılan gönderiler içindeki çapa varlığın duygu durumudur.

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/related-subjects 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:168

limit integer QUERY

Döndürülen maksimum sonuç sayısı.

Default:25

cURL Örneği

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

authors
integer (int64) zorunlu

Eşleşen gönderileri temsil eden farklı yazarlar.

average_sentiment_score
number (double) zorunlu

İstenen penceredeki tüm çapa gönderilerinin ortalama duygu puanı.

from
string (date-time) zorunlu

Ölçülen pencerenin UTC başlangıcı (dahil).

hours
integer zorunlu

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

posts
integer (int64) zorunlu

İstenen penceredeki eşleşen gönderi sayısı.

subjects
array<object> zorunlu

Keşif işleminin döndürdüğü varlık dışı konular.
subjects[].authors
integer (int64) zorunlu

Eşleşen gönderileri temsil eden farklı yazarlar.

subjects[].bearish_posts
integer (int64) zorunlu

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

subjects[].bullish_posts
integer (int64) zorunlu

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

subjects[].first_post_at
string (date-time) isteğe bağlı

İstenen penceredeki ilk eşleşen gönderinin UTC zamanı.

subjects[].last_post_at
string (date-time) isteğe bağlı

İstenen penceredeki en son eşleşen gönderinin UTC zamanı.

subjects[].name
string zorunlu

İnsan tarafından okunabilir ad.

subjects[].neutral_posts
integer (int64) zorunlu

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

subjects[].posts
integer (int64) zorunlu

İstenen penceredeki eşleşen gönderi sayısı.

subjects[].posts_delta
number (double) zorunlu

posts_prior değerinden posts_recent değerine oransal değişim; pozitif değerler büyümeyi gösterir.

subjects[].posts_prior
integer (int64) zorunlu

İstenen pencerenin ilk yarısındaki eşleşen gönderiler.

subjects[].posts_recent
integer (int64) zorunlu

İstenen pencerenin ikinci yarısındaki eşleşen gönderiler.

subjects[].sentiment_delta
number (double) zorunlu

Paylaşılan konuşmanın sentiment_score değeri ile çapa varlığın tüm pencere ortalaması arasındaki fark.

subjects[].sentiment_score
number (double) zorunlu

İşaretli duygu durumu puanı; pozitif yükseliş, negatif düşüş yönündedir.

subjects[].share
number (double) zorunlu

Bu konudan da söz eden çapa gönderilerin, penceredeki tüm çapa gönderilerine ondalık oranı.

subjects[].subject_id
string zorunlu

Varlık olmayan bir kişi, hesap veya konu için kanonik tanımlayıcı.

to
string (date-time) zorunlu

Ölçülen pencerenin UTC bitişi (hariç).

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}