Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON

REST API
Kümeler

Küme duruşları

GET /clusters/stances

GetClusterStances

Bir kümenin en çok tartışılan varlıklarına ilişkin duruşu, piyasanınkinin yanında, −1 (tümü düşüş yönlü) ile +1 (tümü yükseliş yönlü) arasında. contrarian_share, piyasanın tersi yöne ne sıklıkla meylettiğidir; karşılaştırma için diğer kümelerin ortalaması da verilir.

Parametre kuralları:

cluster_id gönderin.
cluster_id tek bir kümeyi adlandırır; birkaçını karşılaştırmak için her küme için bir kez çağırın veya tüm kümeler için tek seferde /clusters kullanın.
Gönderi toplulukları (wallstreetbets, reddit) yalnızca hisse senetlerini kapsar: bunlardan biriyle asset_class mutlaka equity içermelidir.

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

Parametreler

cluster_id string QUERY zorunlu

Analiz edilecek küme, /clusters tarafından döndürüldüğü biçimde, örneğin smart_money veya wallstreetbets. /sentiment parametresinin clusters değerinden alınan herhangi bir id.

Example:smart_money

asset_class array<string> QUERY

Analiz edilecek piyasalar: equity, commodity, index ve crypto değerlerinden herhangi biri, virgülle ayrılmış. Varsayılan olarak dördü de kullanılır. Birden fazlasını virgülle ayırarak gönderin.

Default:equity,commodity,index,crypto

days integer QUERY

Tutumların kaç tam UTC günü üzerinden ölçüleceği, en son tam günden geriye doğru sayılır: 7, 30 veya 90. Ücretsiz planlar 90 güne kadar erişir; daha fazlası 403 döndürür.

İzin verilen değerler

73090

Default:30

limit integer QUERY

Döndürülen maksimum varlık sayısı.

Default:30

cURL Örneği

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/stances' \
  --data-urlencode 'cluster_id=smart_money' \
  --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

asset_classes

array<string> zorunlu

Analiz edilen piyasalar, equity, commodity, index, crypto sırasıyla: istenen asset_class değerleri veya asset_class atlandığında dördü.

assets

array<object> zorunlu

Kümenin en çok tartışılan uygun varlıkları (3 veya daha fazla küme gönderisi, 20 veya daha fazla piyasa gönderisi), limit'e kadar.

assets[].asset_class

string zorunlu

Varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. Her asset kapsamlı istekte asset_id ile birlikte gönderin.

İzin verilen değerler

equitycommodityindexcrypto

assets[].asset_id

string zorunlu

Kanonik genel varlık tanımlayıcısı: hisseler, emtialar ve endeksler için ticker veya piyasa sembolü, kripto için CoinGecko slug'ı (yoksa sayısal bir id).

assets[].cluster_posts

integer (int64) zorunlu

Kümenin pencere boyunca varlık hakkındaki gönderileri.

assets[].cluster_stance

number (double) zorunlu

Kümenin pencere boyunca varlığa ilişkin net duruşu: (yükseliş − düşüş) / (yükseliş + düşüş) gönderi, −1 (tümü düşüş yönlü) ile +1 (tümü yükseliş yönlü) arasında.

assets[].market_stance

number (double) zorunlu

Piyasanın aynı pencere boyunca aynı varlık hakkındaki net tutumu, aynı −1 ile +1 ölçeğinde, botlar hariç tüm yazarlardan.

assets[].name

string zorunlu

İnsan tarafından okunabilir ad.

assets[].symbol

string zorunlu

Görünen ticker veya piyasa sembolü.

cluster_id

string zorunlu

Analiz edilen küme, kanonik cluster_id değeri olarak.

contrarian_share

number (double) zorunlu

Kümenin ve piyasanın zıt yönlere meylettiği uygun varlıkların payı; her ikisi de nötrden en az 0,1 uzakta. 5 varlığın altında null.

days

integer zorunlu

Pencere uzunluğu tam UTC günü cinsinden, en son tam günde sona erer.

peer_average_contrarian_share

number (double) zorunlu

contrarian_share'in diğer kümeler üzerinden ortalaması; hiçbirinde yoksa null.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}