Nebula CLI
Hisse senetleri, emtialar, endeksler, kripto ve AI genelinde küresel piyasa istihbaratını terminalinizden, betiklerinizden veya CI'dan sorgulayın.
Yükle
CLI, Node.js 18 veya üzerini gerektirir.
npm install --global @hiddensystems/nebula-cli
Kimlik Doğrulama
nebula auth login --key YOUR_API_KEY
CLI, anahtarı yalnızca sahibinin erişebildiği izinlerle ~/.nebula/config.json içinde saklar. Otomasyon için bunun yerine NEBULA_API_KEY ayarlayın.
x402 Ödemeleri
Uygun API okumaları için ayrıca, Nebula hesabı veya API anahtarı olmadan, ayrı x402 HTTP API'si üzerinden Base üzerinde USDC ile ödeme yapabilirsiniz. Her ödemeyi cüzdanınız yetkilendirir. MCP ve CLI bağlantıları hesap kimlik doğrulamasını ve kredileri kullanmaya devam eder; otomatik olarak cüzdan ödemesi yapmazlar. x402 ödeme kılavuzuna bakın.
Örnekler
nebula api list_assets --asset-class equity --query NVIDIA
nebula api get_sentiment
nebula api get_mindshare --asset-id NVDA --asset-class equity
nebula api create_chat_completion --body '{"messages":[{"content":"What changed in NVIDIA sentiment this week?","role":"user"}],"stream":false,"thinking_mode":"auto"}'
Uç Noktalara Genel Bakış
Her CLI komutu, REST API, MCP, CLI ve Nebula Agent ile aynı işlem düzeyindeki fiyatlandırmayı ve paylaşılan hesap bakiyesini kullanır.
- Sabit maliyetli işlemler, istek başına listelenen kredi sayısını harcar.
- Parametreler bir işlemin maliyetini değiştirmez; ancak satırında bir parametre için fiyat belirtilen durumlar hariçtir: refresh=true ile yeniden çalıştırılan bir mindshare veya sentiment tahmini 5 yerine 10 kredi tutar. Sentiment, küme filtreleri olsun ya da olmasın her zaman 1 kredi tutar.
- Bir satır, daha düşük bir yanıt için daha düşük bir fiyat da belirtebilir: varlığın sahip olamayacağı bir tahmin (not_forecastable) ücretsizdir; hesap başına saatte en fazla 30 bu tür yanıt. Bunun ötesinde uç nokta, saat dolana kadar 429 döner. Hatayla sonuçlanan bir istek hiçbir ücrete tabi değildir.
- Agent istekleri, token hacmi, model maliyeti ve araç çağrılarına dayalı değişken fiyatlandırma kullanır. Tamamlanan yanıt, kullanılan kredileri bildirir.
- Her işlem her planda kullanılabilir. Planlar geçmiş penceresi (Free: 90 gün; Pro: her uç noktanın maksimumu, çoğu zaman serisi için bir yıl), hız sınırı (Free: dakikada 60 istek; Pro: 300) ve dahil edilen aylık krediler bakımından farklılık gösterir; kredi satın almak kullanımı uzatır ancak geçmiş penceresini veya hız sınırlarını değiştirmez.
Keşif
| Komut | Krediler | Açıklama |
nebula api screener |
2 |
Tarayıcı |
nebula api get_top_momentum |
2 |
En yüksek momentum |
nebula api get_top_trending |
2 |
En çok trend olanlar |
Sorgulama
| Komut | Krediler | Açıklama |
nebula api list_assets |
1 |
Metinden varlık ID'si |
nebula api search |
1 |
Arama |
nebula api list_subjects |
1 |
Metinden konu ID'si |
Sosyal & Duygu Durumu
| Komut | Krediler | Açıklama |
nebula api get_emotions |
1 |
Duygu dağılımı |
nebula api get_mindshare |
2 |
Zihin Payı |
nebula api get_related_subjects |
2 |
İlgili konular |
nebula api get_sentiment |
1 |
Duygu Durumu |
nebula api get_sentiment_timeframes |
1 |
Zaman dilimine göre duyarlılık |
nebula api get_social_momentum |
2 |
Sosyal momentum |
Tahminler
| Komut | Krediler | Açıklama |
nebula api list_forecast_assets |
1 |
Tahmin edilebilir varlıklar |
nebula api get_mindshare_forecast |
5 (refresh=true ile 10; not_forecastable ise ücretsiz, saatte 30) |
Mindshare tahmini |
nebula api get_sentiment_forecast |
5 (refresh=true ile 10; not_forecastable ise ücretsiz, saatte 30) |
Duyarlılık tahmini |
Piyasa Duygu Durumu
| Komut | Krediler | Açıklama |
nebula api get_calls |
2 |
Long/short çağrıları |
nebula api get_call_returns |
2 |
Çağrı sonucu dağılımı |
nebula api get_conviction_index |
2 |
Kanaat endeksi |
nebula api get_fear_greed_index |
1 |
Korku ve Açgözlülük endeksi |
nebula api get_price_levels |
2 |
Sosyal olarak bahsedilen fiyat seviyeleri |
nebula api get_social_volume_index |
2 |
Sosyal hacim ile işlem hacmi |
nebula api get_social_volume_profile |
2 |
Sosyal hacim profili |
Piyasa Verileri
| Komut | Krediler | Açıklama |
nebula api get_price_history |
1 |
Fiyat geçmişi |
İstihbarat
| Komut | Krediler | Açıklama |
nebula api list_calendar_events |
5 |
Takvim etkinlikleri |
nebula api list_insights |
5 |
İstihbarat |
nebula api get_insight_attention |
5 |
Insight ilgisi |
Kümeler
| Komut | Krediler | Açıklama |
nebula api list_clusters |
2 |
Yazar kümeleri |
nebula api compare_clusters |
2 |
Küme karşılaştırması |
nebula api get_divisive_assets |
2 |
Bölücü varlıklar |
nebula api compare_hype_cycles |
2 |
Hype döngüsü varışları |
nebula api compare_cluster_traits |
2 |
Küme özelliği karşılaştırması |
nebula api get_cluster_hype_cycles |
2 |
Küme hype döngüleri |
nebula api get_cluster_overlap |
2 |
Küme örtüşmesi |
nebula api get_cluster_profile |
2 |
Küme profili |
nebula api get_cluster_rotation |
2 |
Küme rotasyonu |
nebula api get_cluster_stances |
2 |
Küme duruşları |
Agent
| Komut | Krediler | Açıklama |
nebula api create_chat_completion |
Değişken |
Nebula Agent sohbet tamamlamaları |
Hesap
| Komut | Krediler | Açıklama |
nebula api get_account |
0 |
Hesap |
Oluşturulmuş Komutlar
Yollar, yöntemler, yardım metni, varsayılanlar, seçici kısıtlamaları, istek şemaları ve doğrulama doğrudan OpenAPI'den gelir.
nebula api compare_cluster_traits | Küme özelliği karşılaştırması |
|---|
nebula api compare_clusters | Küme karşılaştırması |
|---|
nebula api compare_hype_cycles | Hype döngüsü varışları |
|---|
nebula api create_chat_completion | Nebula Agent sohbet tamamlamaları |
|---|
nebula api get_account | Hesap |
|---|
nebula api get_call_returns | Çağrı sonucu dağılımı |
|---|
nebula api get_calls | Long/short çağrıları |
|---|
nebula api get_cluster_hype_cycles | Küme hype döngüleri |
|---|
nebula api get_cluster_overlap | Küme örtüşmesi |
|---|
nebula api get_cluster_profile | Küme profili |
|---|
nebula api get_cluster_rotation | Küme rotasyonu |
|---|
nebula api get_cluster_stances | Küme duruşları |
|---|
nebula api get_conviction_index | Kanaat endeksi |
|---|
nebula api get_divisive_assets | Bölücü varlıklar |
|---|
nebula api get_emotions | Duygu dağılımı |
|---|
nebula api get_fear_greed_index | Korku ve Açgözlülük endeksi |
|---|
nebula api get_insight_attention | Insight ilgisi |
|---|
nebula api get_mindshare | Zihin Payı |
|---|
nebula api get_mindshare_forecast | Mindshare tahmini |
|---|
nebula api get_price_history | Fiyat geçmişi |
|---|
nebula api get_price_levels | Sosyal olarak bahsedilen fiyat seviyeleri |
|---|
nebula api get_related_subjects | İlgili konular |
|---|
nebula api get_sentiment | Duygu Durumu |
|---|
nebula api get_sentiment_forecast | Duyarlılık tahmini |
|---|
nebula api get_sentiment_timeframes | Zaman dilimine göre duyarlılık |
|---|
nebula api get_social_momentum | Sosyal momentum |
|---|
nebula api get_social_volume_index | Sosyal hacim ile işlem hacmi |
|---|
nebula api get_social_volume_profile | Sosyal hacim profili |
|---|
nebula api get_top_momentum | En yüksek momentum |
|---|
nebula api get_top_trending | En çok trend olanlar |
|---|
nebula api list_assets | Metinden varlık ID'si |
|---|
nebula api list_calendar_events | Takvim etkinlikleri |
|---|
nebula api list_clusters | Yazar kümeleri |
|---|
nebula api list_forecast_assets | Tahmin edilebilir varlıklar |
|---|
nebula api list_insights | İstihbarat |
|---|
nebula api list_subjects | Metinden konu ID'si |
|---|
nebula api screener | Tarayıcı |
|---|
nebula api search | Arama |
|---|
JSON ve Kodlama Ajanları
Makine tarafından okunabilir çıktı için --json ekleyin. Herhangi bir işlem için oluşturulan parametreleri görmek üzere nebula api <operation_id> --help çalıştırın.
MCP Yardımcısı
MCP istemci yapılandırmasını yazdırmak için nebula mcp çalıştırın. Kurulum ayrıntıları için MCP belgelerine bakın.
CI ve Otomasyon
NEBULA_API_KEY değerini gizli yöneticinizde ayarlayın ve yapılandırılmış çıktı için --json kullanın. NEBULA_API_BASE_URL yalnızca geliştirme veya kendi barındırdığınız API'ler için kullanın.