Sosyal hacim profili

GET /social-volume-profile
GetSocialVolumeProfile

İşlemler yerine gönderilerden oluşan bir hacim profili: bir varlık hakkındaki sohbetin fiyat ekseninde nerede gerçekleştiği. Her kovada gönderi sayıları, boğa ve ayı payları ve directional_imbalance −1 (tümü ayı) ile +1 (tümü boğa) arasında bulunur; significance_score kovaları gönderiler, denge, fiyatın onlara ne sıklıkla geri döndüğü ve sıkışma açısından 0 ile 1 arasında sıralar; kontrol noktası en yoğun kovadır. Tek bir grubu profillemek için clusters gönderin.

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

Parametreler

asset_id string QUERY zorunlu

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

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

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

bins integer QUERY

Fiyat kovası sayısı.

Default:30

clusters array<string> QUERY

Okunacak yazar kümeleri; birleştirmek için tekrarlayın, örneğin clusters=kols&clusters=media. Seçilen kümeler toplanır ve bir yazar birden fazla kümeye ait olabilir.

  • Callers: smart_money (en iyi performans gösteren çağrıcılar), dumb_money (en kötü performans gösterenler), top_degens (küçük ölçekli kriptoda en iyiler)
  • Timing: early_movers (dikkat artarken bir varlık hakkında ilk konuşanlar), late_movers (zirvede veya sonrasında gelenler)
  • Geliştiriciler: developers, founders, team_leaders, project_accounts
  • Kurumlar: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Etki: kols, celebrities, media, marketer, shiller
  • Analistler: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Trader'lar: position_trader, swing_trader, day_trader
  • Eğilim: perma_bull, doomer, tribalist
  • Diğer: political, nft, bots, automated_ai
  • Gönderinin yapıldığı yere göre topluluklar: wallstreetbets, reddit

Example:smart_money

cURL Örneği

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

bins
array<object> zorunlu

Düşükten yükseğe sıralanmış fiyat kovaları.

bins[].balance_score
number (double) zorunlu

Etkinliğin yönler arasında ne kadar eşit bölündüğü, 0 ile 1 arası.

bins[].bearish_posts
number (double) zorunlu

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

bins[].bearish_share
number (double) zorunlu

Bu kovadaki yönlü gönderilerin ayı payı, 0 ile 1 arası.

bins[].bullish_posts
number (double) zorunlu

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

bins[].bullish_share
number (double) zorunlu

Bu kovadaki yönlü gönderilerin boğa payı, 0 ile 1 arası.

bins[].compression_score
number (double) zorunlu

Fiyat kovadayken ne kadar yavaş hareket ettiği, 0 ile 1 arası.

bins[].directional_imbalance
number (double) isteğe bağlı

Yönlü gönderi dengesizliği (boğa − ayı) / (boğa + ayı), −1 ile 1 arası; yönlü gönderi yoksa bulunmaz.

bins[].is_point_of_control
boolean zorunlu

En fazla gönderi etkinliğini içeren kova için true.

bins[].neutral_posts
number (double) zorunlu

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

bins[].price_high_usd
number (double) zorunlu

Fiyat kovasının dışlayıcı üst kenarı, ABD doları cinsinden.

bins[].price_low_usd
number (double) zorunlu

Fiyat kovasının kapsayıcı alt kenarı, ABD doları cinsinden.

bins[].price_mid_usd
number (double) zorunlu

Fiyat kovasının orta noktası, ABD doları cinsinden.

bins[].significance_score
number (double) zorunlu

Kova için bileşik belirginlik puanı, 0 ile 1 arası.

bins[].total_posts
number (double) zorunlu

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

bins[].total_share
number (double) zorunlu

En yoğun kovaya göre gönderi sayısı, 0 ile 1 arası.

bins[].visit_count
integer zorunlu

Pencere boyunca piyasa fiyatının bu kovaya ayrı ayrı giriş sayısı.

maximum_posts_in_bin
number (double) zorunlu

En yoğun fiyat kovasındaki gönderi sayısı.

maximum_price_usd
number (double) zorunlu

Profildeki en yüksek fiyat, ABD doları cinsinden.

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.bin_count
integer zorunlu

İstenen fiyat kovası sayısı.

metadata.clusters
array<string> isteğe bağlı

Sonuçlar kanonik yazar kümesi tanımlayıcısına göre anahtarlanmış veya gruplanmış.

metadata.hours
integer zorunlu

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

metadata.priced_buckets
integer zorunlu

Bir piyasa fiyatıyla başarıyla eşleştirilen duyarlılık kovaları.

metadata.unpriced_buckets
integer zorunlu

Yakında bir piyasa fiyatı bulunamadığı için atlanan duyarlılık kovaları.

minimum_price_usd
number (double) zorunlu

Profildeki en düşük fiyat, ABD doları cinsinden.

point_of_control_bin_index
integer isteğe bağlı

En yoğun kovanın sıfır tabanlı dizini; profil boş olduğunda bulunmaz.

total_posts
number (double) zorunlu

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

{
  "bins": [
    {
      "balance_score": 0.64,
      "bearish_posts": 438,
      "bearish_share": 0.32,
      "bullish_posts": 1120,
      "bullish_share": 0.68,
      "compression_score": 0.78,
      "directional_imbalance": 0.36,
      "is_point_of_control": true,
      "neutral_posts": 284,
      "price_high_usd": 180,
      "price_low_usd": 175,
      "price_mid_usd": 177.5,
      "significance_score": 0.87,
      "total_posts": 1842,
      "total_share": 0.82,
      "visit_count": 6
    }
  ],
  "maximum_posts_in_bin": 286,
  "maximum_price_usd": 188.75,
  "minimum_price_usd": 161.25,
  "point_of_control_bin_index": 14,
  "total_posts": 1842
}