Saltar al contenido principal
La Helius CLI es una interfaz de línea de comandos completa para la plataforma Helius. Proporciona más de 95 comandos para administrar cuentas, consultar datos de blockchain, enviar transacciones, gestionar webhooks, transmitir datos en tiempo real, hacer staking, usar ZK Compression y mucho más. Además, ofrece resultados JSON procesables por máquinas para cada comando.
¿Usas una herramienta de IA compatible con MCP? El servidor MCP de Helius es la forma recomendada para que los agentes de IA interactúen con Helius. Proporciona 10 herramientas enrutadas con entradas y salidas estructuradas, incluido el registro de cuentas integrado. Usa la CLI para scripts de shell, pipelines de CI/CD o cuando MCP no esté disponible.

Instalación

Inicio rápido — Usuarios existentes

Si ya tienes una clave de API de Helius, solo configúrala y comienza:
Obtén tu clave en dashboard.helius.dev. Eso es todo; omite los pasos de registro que aparecen a continuación.

Inicio rápido — Usuarios nuevos

Las invocaciones de helius signup que crean cuentas requieren --email, --first-name y --last-name, incluido el plan Agent. Tu billetera solo se usa para pagar; no reemplaza tus datos de contacto. helius signup --resume, que completa un registro existente después de pagar mediante el enlace alojado, no necesita ningún otro parámetro.
1

Generate a keypair

Resultado:
La sugerencia de fondos anterior solo se aplica si usarás el pago automático. No agregues fondos si planeas pagar mediante el enlace alojado.
2

Create account

Hay dos modos de pago: enlace alojado (paga desde cualquier billetera sin agregar fondos) o pago automático (paga USDC desde el par de claves local, que debe contener aproximadamente 0.001 SOL más el importe del plan).
3

Get your API keys and endpoints

Tu clave de API es información confidencial que permite acceder a tu cuenta de Helius. Nunca la expongas en código del lado del cliente, repositorios públicos ni áreas accesibles desde el navegador.

Planes y precios

Puedes comprar cualquier plan compartido de Helius directamente mediante la CLI. Pasa --plan durante el registro o usa helius upgrade más adelante:
Todos los precios que se muestran en dólares están expresados en dólares estadounidenses (USD).
El plan Agent (agent) es el predeterminado. Cuesta $10 (pagados en USDC) para evitar abusos y te da 1,000,000 de créditos. Para obtener límites de tasa más altos y más créditos, regístrate con un plan de pago o actualiza tu plan más adelante.

Registro con un plan específico

Actualizar una cuenta existente

Pagar una renovación

Cuando vence la renovación de una suscripción (mensual o anual), Helius crea una intención de pago: un pago pendiente con un ID, un monto y una fecha de vencimiento únicos. Recibirás el ID de la intención de pago por correo electrónico o en el panel.
El comando obtiene los detalles de la intención, muestra el monto y la fecha de vencimiento, solicita confirmación y luego envía el pago en USDC desde la billetera de tu par de claves.

Referencia de comandos

La CLI proporciona más de 95 comandos en 14 categorías. Todos los comandos admiten --json para generar una salida legible por máquina y las anulaciones globales --api-key <key> / --network <net>.

Full Command Reference

Más de 95 comandos: administración de cuentas, consultas de blockchain, API de DAS, billeteras, webhooks, envío de transacciones, WebSockets, staking, compresión ZK y mucho más

Modo de salida JSON

Agrega --json a cualquier comando para generar una salida legible por máquina:
Ejemplo:

Códigos de salida

Los agentes deben comprobar los códigos de salida para garantizar una automatización confiable:

Configuración

La configuración se almacena en ~/.helius/:
Administra la configuración con:

Orden de resolución de claves de API

Las claves de API se resuelven en este orden:
  1. Opción --api-key <key> (anulación por comando)
  2. Variable de entorno HELIUS_API_KEY
  3. ~/.helius/config.json (se establece mediante helius config set-api-key)

Opciones globales

Todos los comandos aceptan estas opciones:

Flujo de trabajo completo del agente

Próximos pasos

Agents Overview

Orientación sobre la API, flujos de trabajo y manejo de errores para agentes

Helius MCP

Conecta herramientas de IA directamente con las API de Helius

View Plans

Conoce los planes de Helius y las opciones de actualización

Dashboard

Supervisa tu uso de la API y administra las claves

Soporte

Discord Community

Únete a nuestro Discord para obtener ayuda en tiempo real y soporte de la comunidad

Email Support

Comunícate directamente con nuestro equipo de soporte