Long/short çağrıları

GET /calls

GetCalls

İnsanların bir varlık üzerinde ya da tüm piyasalarda zaman içinde kaç uzun ve kısa çağrı yaptığı. Bir çağrı, bir varlığın yükseleceğini veya düşeceğini söyler, bir pozisyon açıklar ya da başkalarına pozisyon almasını söyler; salt görüş sayılmaz. Bir grubun çağrılarını saymak için clusters gönderin.

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

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:720

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' \
  --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

series

array<object> zorunlu

Kronolojik olarak sıralanmış gözlemler.

series[].long_calls

integer (int64) zorunlu

Kovadaki uzun çağrı sayısı.

series[].short_calls

integer (int64) zorunlu

Kovadaki kısa çağrı sayısı.

series[].timestamp

string zorunlu

Gözlem veya kova başlangıcı için UTC RFC 3339 zaman damgası.

{
  "series": [
    {
      "long_calls": 184,
      "short_calls": 71,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}