CLI di Nebula

Installa

La CLI richiede Node.js 18 o versione successiva.

npm install --global @hiddensystems/nebula-cli

Autenticazione

nebula auth login --key YOUR_API_KEY

La CLI archivia la chiave in ~/.nebula/config.json con permessi di accesso riservati al proprietario. Per l'automazione imposta invece NEBULA_API_KEY.

Pagamenti x402

Puoi anche pagare le letture API idonee con USDC su Base tramite l'API HTTP x402 separata, senza un account Nebula o una chiave API. Il tuo wallet autorizza ogni pagamento. Le connessioni MCP e CLI continuano a usare l'autenticazione dell'account e i crediti; non effettuano automaticamente pagamenti dal wallet. Consulta la guida ai pagamenti x402.

Esempi

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"}'

Panoramica degli endpoint

Ogni comando CLI usa la stessa tariffazione a livello di operazione e lo stesso saldo account condiviso dell'API REST, di MCP, della CLI e di Nebula Agent.

• Le operazioni a costo fisso consumano il numero di crediti indicato per richiesta.
• I parametri non modificano il costo di un'operazione, tranne dove la relativa riga indica un prezzo specifico: una previsione di mindshare o sentiment rieseguita con refresh=true costa 10 crediti invece di 5. Il sentiment costa sempre 1 credito, con o senza filtri di cluster.
• Una riga può anche indicare un prezzo inferiore per una risposta di livello inferiore: una previsione che l'asset non può avere (not_forecastable) è gratuita, fino a 30 risposte di questo tipo per account all'ora; oltre tale soglia l'endpoint risponde 429 finché l'ora non si azzera. Una richiesta che termina con un errore non costa nulla.
• Le richieste dell'Agent usano prezzi variabili in base al volume di token, al costo del modello e alle chiamate agli strumenti. La risposta completata riporta i crediti utilizzati.
• Ogni operazione è disponibile in tutti i piani. I piani si differenziano per finestra storica (Free: 90 giorni; Pro: il massimo di ogni endpoint, un anno per la maggior parte delle serie temporali), limite di frequenza (Free: 60 richieste al minuto; Pro: 300) e crediti mensili inclusi; l'acquisto di crediti estende l'utilizzo ma non modifica la finestra storica né i limiti di frequenza.

Discovery

Lookup

Social & Sentiment

Previsioni

Sentiment di mercato

Market Data

Intelligence

Cluster

Agent

Account

Comandi generati

Percorsi, metodi, testo di aiuto, valori predefiniti, vincoli dei selettori, schemi delle richieste e validazione provengono direttamente da OpenAPI.

JSON e agenti di coding

Aggiungi --json per un output leggibile dalla macchina. Esegui nebula api <operation_id> --help per visualizzare i parametri generati per qualsiasi operazione.

Helper MCP

Esegui nebula mcp per stampare la configurazione del client MCP. Consulta la documentazione MCP per i dettagli sulla configurazione.

CI e automazione

Imposta NEBULA_API_KEY nel tuo secret manager e usa --json per l'output strutturato. Usa NEBULA_API_BASE_URL solo per lo sviluppo o per API self-hosted.