Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON
  1. REST API
  2. Kümeler

Küme profili

GET /clusters/profile
GetClusterProfile

Bir kümenin davranışsal özellikleri, her biri diğer tüm kümelere göre sıralanmış (rank 1 en yüksektir):

  • earliness (gün): hype döngüsü zirveleri çevresinde ne kadar erken gönderi paylaştığı; pozitif değer erkendir.
  • contrarian (pay): piyasanın tersi yöne meylettiği varlıklar.
  • hype_fade (gün): pozitif, hype biriktikçe daha az boğa eğilimli hale geldiği anlamına gelir.
  • conviction (gün): bir varlık üzerindeki aynı görüşü ne kadar süre koruduğu.
  • focus (pay): en iyi 5 varlığı üzerindeki gönderiler.
  • breadth (sayı): ele aldığı varlıklar.
  • bullishness (oran): yükseliş ve düşüş yönlü gönderileri arasında yükseliş yönlü olanların payı.
  • discovery (oran): piyasanın ilk 100'ü dışındaki varlıklara ilişkin gönderiler.
  • turnover (oran): ilk 10 varlığının haftadan haftaya ne kadar değiştiği.
  • coverage (oran): katıldığı hype döngüleri.

Hype döngüsü, bir varlığın gönderilerinin normalin en az 3 katına çıktığı gündür. Yalnızca tam UTC günleri.

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

Analiz edilecek tam UTC günü sayısı, en son tam günden geriye doğru sayılır: 30 veya 90. Daha uzun pencereler daha fazla hype döngüsü görür, bu yüzden döngü özellikleri daha istikrarlıdır. Ücretsiz planlar 90 güne kadar erişir; daha fazlası 403 döndürür.

İzin verilen değerler
3090

Default:90

cURL Örneği

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

active_clusters
integer zorunlu

Pencerede etkin kümeler: popülasyon özellikleri bunlar içinde sıralanır.

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ü.

cluster_id
string zorunlu

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

days
integer zorunlu

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

hype_cycles
integer zorunlu

Penceredeki piyasa hype döngüleri: gönderileri bir günde 50 veya daha fazlaya ulaşan ve medyan gününün en az 3 katına çıkan varlıklar.

traits
array<object> zorunlu

Özellik başına bir giriş, şu sırayla: earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits[].peer_values
array<number (double)> zorunlu

Diğer her kümenin bu özellik için değeri, artan sırada.

traits[].percentile
number (double) zorunlu

Değeri olan kümeler arasında 0 (en düşük) ile 1 (en yüksek) arasında. Değer null olduğunda null.

traits[].rank
integer zorunlu

1 en yüksek değerdir; eşit kümeler daha iyi sıralamayı paylaşır. Değer null olduğunda null.

traits[].trait
string zorunlu

Ölçülen özellik; her birini işlem açıklaması tanımlar.

İzin verilen değerler
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string zorunlu

gün, pay (0 ile 1 arası) veya sayı; her özellik için sabittir.

İzin verilen değerler
dayssharecount
traits[].value
number (double) zorunlu

Kümenin bu özellik için değeri, birim cinsinden; kümenin bunun için çok az verisi olduğunda null.

{
  "active_clusters": 34,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "peer_values": [
        -1.8,
        -0.64,
        0.12,
        0.87,
        2.05
      ],
      "percentile": 0.9394,
      "rank": 3,
      "trait": "earliness",
      "unit": "days",
      "value": 1.42
    },
    {
      "peer_values": [
        0.041,
        0.083,
        0.112,
        0.204,
        0.267
      ],
      "percentile": 0.7576,
      "rank": 9,
      "trait": "contrarian",
      "unit": "share",
      "value": 0.1875
    },
    {
      "peer_values": [
        -1.1,
        -0.3,
        0.2,
        0.9,
        1.4
      ],
      "percentile": 0.8182,
      "rank": 7,
      "trait": "hype_fade",
      "unit": "days",
      "value": 0.6
    },
    {
      "peer_values": [
        1.4,
        1.9,
        2.2,
        2.8,
        3.6
      ],
      "percentile": 0.6667,
      "rank": 12,
      "trait": "conviction",
      "unit": "days",
      "value": 2.35
    },
    {
      "peer_values": [
        0.18,
        0.24,
        0.35,
        0.47,
        0.72
      ],
      "percentile": 0.4242,
      "rank": 20,
      "trait": "focus",
      "unit": "share",
      "value": 0.31
    },
    {
      "peer_values": [
        41,
        96,
        188,
        405,
        1270
      ],
      "percentile": 0.8485,
      "rank": 6,
      "trait": "breadth",
      "unit": "count",
      "value": 312
    },
    {
      "peer_values": [
        0.52,
        0.64,
        0.71,
        0.78,
        0.86
      ],
      "percentile": 0.6061,
      "rank": 14,
      "trait": "bullishness",
      "unit": "share",
      "value": 0.7412
    },
    {
      "peer_values": [
        0.09,
        0.17,
        0.26,
        0.38,
        0.61
      ],
      "percentile": 0.5152,
      "rank": 17,
      "trait": "discovery",
      "unit": "share",
      "value": 0.2837
    },
    {
      "peer_values": [
        0.18,
        0.27,
        0.36,
        0.44,
        0.58
      ],
      "percentile": 0.3939,
      "rank": 21,
      "trait": "turnover",
      "unit": "share",
      "value": 0.3455
    },
    {
      "peer_values": [
        0.05,
        0.22,
        0.41,
        0.63,
        0.88
      ],
      "percentile": 0.7879,
      "rank": 8,
      "trait": "coverage",
      "unit": "share",
      "value": 0.6585
    }
  ]
}