Küme örtüşmesi

GET /clusters/overlap
GetClusterOverlap

Hangi kümeler bu kümeyle aynı varlıkları izliyor ve aynı yönde mi düşünüyorlar. overlap_share, bir eşin bu kümenin en iyi 50 varlığının ne kadarını paylaştığıdır; direction_agreement_share ne sıklıkla aynı yöne meylettikleridir; stance_gap bu kümenin daha boğa eğilimli olduğu durumlarda pozitiftir.

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

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

İzin verilen değerler
73090

Default:30

cURL Örneği

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

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.

peers
array<object> zorunlu

Diğer tüm aktif kümeler, en çok örtüşen önce.

peers[].agreeing_asset_count
integer zorunlu

Her iki kümenin de piyasaya göre aynı yöne meylettiği karşılaştırılan varlıklar.

peers[].cluster_id
string zorunlu

Kanonik yazar kümesi tanımlayıcısı.

peers[].compared_asset_count
integer zorunlu

Tüm örtüşme genelinde, her iki kümenin de piyasanın duruşundan en az 0.05 saptığı paylaşılan varlıklar.

peers[].direction_agreement_share
number (double) zorunlu

Her iki kümenin de piyasanın duruşundan en az 0.05 saptığı paylaşılan varlıklarda, aynı yöne meylettikleri pay: agreeing_asset_count ÷ compared_asset_count. 3 varlığın altında null.

peers[].overlap_share
number (double) zorunlu

Bu kümenin odak kümesinin eşin odak kümesinde de bulunma payı, 0 ile 1 arası.

peers[].shared_assets
array<object> zorunlu

Her iki odak kümesinde de bulunan en fazla 5 varlık, bu kümenin dikkat sırasına göre.

peers[].shared_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
peers[].shared_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).

peers[].shared_assets[].cluster_stance
number (double) zorunlu

Bu kümenin varlık üzerindeki net duruşu, −1 ile +1 arası. 3 boğa veya ayı gönderisinin altında null.

peers[].shared_assets[].market_stance
number (double) zorunlu

Piyasanın varlık üzerindeki net duruşu, −1 ile +1 arası: her iki meylin de ölçüldüğü temel. 3 boğa veya ayı gönderisinin altında null.

peers[].shared_assets[].name
string zorunlu

İnsan tarafından okunabilir ad.

peers[].shared_assets[].peer_stance
number (double) zorunlu

Eşin varlık üzerindeki net duruşu, −1 ile +1 arası. 3 boğa veya ayı gönderisinin altında null.

peers[].shared_assets[].symbol
string zorunlu

Görünen ticker veya piyasa sembolü.

peers[].stance_gap
number (double) zorunlu

Bu kümenin duruşu eksi eşin duruşu, her ikisinin de duruşu olan paylaşılan varlıklar üzerinden ortalanmış, −2 ile +2 arası. Pozitif, bu kümenin daha boğa eğilimli olduğu anlamına gelir. 3 varlığın altında null.

top_asset_count
integer zorunlu

Her kümenin odak kümesinin boyutu: en çok tartışılan varlıkları, en fazla bu sayı kadar.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}