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

Çağrı sonucu dağılımı

GET /calls/returns
GetCallReturns

Son çağrıların performansı: kazanma oranı, medyan ve ortalama getiri ile getiri dağılımı. Her çağrı, kendisinden sonraki 24 saat içindeki fiyat hareketine göre çağrıyı yapanın tarafından puanlanır; dolayısıyla %10'luk bir düşüş üzerine yapılan kısa çağrı +%10'dur. Grupları karşılaştırmak için clusters gönderin, örneğin smart_money ile dumb_money.

Parametre kuralları:

  • asset_class ve asset_id birlikte gönderin ya da hiçbirini göndermeyin.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/calls/returns 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

resolved_days integer QUERY

Kaç günlük sonuçlanmış çağrının dahil edileceği: 24 saatlik işareti bu kadar gün içinde geçmiş çağrılar. Ücretsiz planlar 90 güne kadar geriye gider; daha fazlası 403 döndürür.

Default:7

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

Example:smart_money

cURL Örneği

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/calls/returns' \
  --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

average_return_pct
number (double) zorunlu

Sonuçlanmış çağrılar genelinde yönle uyumlu ortalama getiri, yüzde puan cinsinden.

buckets
array<object> zorunlu

Getiri dağılımı kovaları, artan sırada.
buckets[].call_count
integer (int64) zorunlu

Bu getiri kovasındaki sonuçlanmış çağrılar.

buckets[].capped_total_aligned_return_pct
number (double) zorunlu

Her çağrının ±%100 ile sınırlandığı, yönle uyumlu getirilerin toplamı; yüzde puan cinsinden.

buckets[].label
string zorunlu

İnsan tarafından okunabilir kova veya endeks etiketi.

buckets[].lower_bound_pct
number (double) zorunlu

Kapsayıcı alt getiri sınırı, yüzde puan cinsinden; ilk, üst sınırı olmayan kova için null.

buckets[].total_aligned_return_pct
number (double) zorunlu

Bu kovadaki yönle uyumlu getirilerin toplamı, yüzde puan cinsinden.

buckets[].upper_bound_pct
number (double) zorunlu

Dışlayıcı üst getiri sınırı, yüzde puan cinsinden; son, üst sınırı olmayan kova için null.

losses
integer (int64) zorunlu

Yönle uyumlu getirisi negatif olan sonuçlanmış çağrılar.

median_return_pct
number (double) zorunlu

Sonuçlanmış çağrılar genelinde medyan yönle uyumlu getiri, yüzde puan cinsinden.

resolved_calls
integer (int64) zorunlu

Sonucu netleşmiş çağrıların sayısı.

resolved_days
integer zorunlu

İstatistiklerin kaç günlük sonuçlanmış çağrıyı kapsadığı.

win_rate_pct
number (double) zorunlu

Kazanan sonuçlanmış çağrıların 0 ile 100 arasında yüzde olarak ifadesi.

wins
integer (int64) zorunlu

Yönle uyumlu getirisi pozitif olan sonuçlanmış çağrılar.

{
  "average_return_pct": 4.1,
  "buckets": [
    {
      "call_count": 91,
      "capped_total_aligned_return_pct": -228,
      "label": "-10% to 0%",
      "lower_bound_pct": -10,
      "total_aligned_return_pct": -342.5,
      "upper_bound_pct": 0
    }
  ],
  "losses": 174,
  "median_return_pct": 2.8,
  "resolved_calls": 412,
  "resolved_days": 7,
  "win_rate_pct": 57.77,
  "wins": 238
}