CLI de Nebula

Instalar

La CLI requiere Node.js 18 o posterior.

npm install --global @hiddensystems/nebula-cli

Autenticación

nebula auth login --key YOUR_API_KEY

La CLI almacena la clave en ~/.nebula/config.json con permisos exclusivos para el propietario. En su lugar, define NEBULA_API_KEY para la automatización.

Pagos x402

También puedes pagar lecturas de API elegibles con USDC en Base a través de la API HTTP x402 independiente, sin necesidad de una cuenta de Nebula ni de una clave de API. Tu cartera autoriza cada pago. Las conexiones de MCP y CLI siguen usando la autenticación de cuenta y los créditos; no realizan pagos automáticos con cartera. Consulta la guía de pagos x402.

Ejemplos

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

Descripción general de los endpoints

Cada comando de la CLI usa el mismo precio por operación y el mismo saldo de cuenta compartido que la API REST, MCP, la CLI y Nebula Agent.

• Las operaciones de costo fijo gastan la cantidad de créditos indicada por solicitud.
• Los parámetros no modifican el coste de una operación, salvo cuando su fila indica un precio para uno de ellos: una previsión de mindshare o de sentimiento reejecutada con refresh=true cuesta 10 créditos en lugar de 5. El sentimiento siempre cuesta 1 crédito, con o sin filtros de clúster.
• Una fila también puede indicar un precio menor para una respuesta de menor alcance: un pronóstico que el activo no puede tener (not_forecastable) es gratuito, hasta 30 de esas respuestas por cuenta por hora; superado ese límite, el endpoint responde 429 hasta que se reinicie la hora. Una solicitud que termina en error no cuesta nada.
• Las solicitudes del Agent usan precios variables según el volumen de tokens, el costo del modelo y las llamadas a herramientas. La respuesta completada informa los créditos utilizados.
• Todas las operaciones están disponibles en todos los planes. Los planes se diferencian por la ventana de historial (Free: 90 días; Pro: el máximo de cada endpoint, un año para la mayoría de las series temporales), el límite de velocidad (Free: 60 solicitudes por minuto; Pro: 300) y los créditos mensuales incluidos; comprar créditos amplía el uso, pero no cambia el historial ni los límites de velocidad.

Descubrimiento

Búsqueda

Social & Sentimiento

Pronósticos

Sentimiento de mercado

Datos de mercado

Inteligencia

Clústeres

Agente

Cuenta

Comandos generados

Las rutas, los métodos, el texto de ayuda, los valores predeterminados, las restricciones de los selectores, los esquemas de solicitud y la validación provienen directamente de OpenAPI.

JSON y agentes de programación

Añade --json para obtener salida legible por máquina. Ejecuta nebula api <operation_id> --help para ver los parámetros generados de cualquier operación.

Asistente de MCP

Ejecuta nebula mcp para imprimir la configuración del cliente de MCP. Consulta la documentación de MCP para obtener detalles de configuración.

CI y automatización

Define NEBULA_API_KEY en tu gestor de secretos y usa --json para obtener salida estructurada. Usa NEBULA_API_BASE_URL solo para desarrollo o API autoalojadas.