Skip to main content
La API de Helius usa claves de API para autenticar las solicitudes. Cada solicitud a la API debe incluir tu clave de API para verificar tu identidad y tus permisos.
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.

Primeros pasos

1. Crea tu clave de API

1

Sign up or log in

Crea una cuenta en el panel de Helius o inicia sesión en tu cuenta existente.
2

Navigate to API Keys

Ve a la sección Claves de API en la barra lateral del panel.
3

Generate a new key

Haz clic en Crear nueva clave de API y proporciona un nombre descriptivo para tu proyecto (por ejemplo, “Aplicación de producción” o “Entorno de desarrollo”).
4

Copy and secure your key

Copia tu clave de API de inmediato y guárdala de forma segura. No podrás volver a verla después de salir de la página.

2. Usa tu clave de API

Incluye tu clave de API como parámetro de consulta en todas las solicitudes:

Primeros pasos (para agentes)

Los agentes pueden registrarse mediante programación para obtener cuentas de Helius, crear proyectos y generar claves de API con la CLI de Helius. Para consultar las instrucciones completas, lee: https://dashboard.helius.dev/agents.md

Instala la CLI de Helius

Genera un par de claves

Agrega fondos a la billetera generada (solo para pagos automáticos)

Omite este paso si pagarás mediante el enlace de pago alojado (el modo de registro predeterminado, que se completa con helius signup --resume). El pago automático (--pay) se realiza desde el par de claves local: envía 1 USDC y 0.001 SOL a la dirección de la billetera proporcionada en el paso 2.

Regístrate y obtén una clave de API

Prácticas recomendadas de seguridad

Environment Variables

Guarda tu clave de API en variables de entorno, no en el código fuente.

IP Restrictions

Configura restricciones de IP para tus claves de API en el panel a fin de limitar el acceso a direcciones o intervalos de IP específicos.

Separate Keys

Usa claves de API diferentes para los entornos de desarrollo, preproducción y producción a fin de aislar el uso y mejorar la seguridad.

Monitor Usage

Revisa periódicamente el uso de tu API en el panel para detectar patrones inusuales o posibles problemas de seguridad.

Administración de secretos

Límites de frecuencia y uso

Los límites de frecuencia varían según el plan de suscripción. Supervisa tu uso en el panel de Helius para asegurarte de mantenerte dentro de los límites asignados.

Comprende los límites de frecuencia

  • Solicitudes por segundo: Según tu nivel de suscripción
  • Cuota mensual de solicitudes: Total de solicitudes permitidas por ciclo de facturación
  • Margen para ráfagas: Picos de corta duración por encima de tu límite de frecuencia base

Gestiona los límites de frecuencia

Solución de problemas

Síntomas: errores 401 No autorizado o “Clave de API no válida”Soluciones:
  • Verifica que tu clave de API sea correcta y no se haya vuelto a generar
  • Comprueba que incluyas la clave de API como parámetro de consulta: ?api-key=YOUR_KEY
  • Asegúrate de que no haya espacios ni caracteres adicionales en tu clave de API
  • Confirma que tu clave de API no haya vencido ni se haya revocado
Síntomas: errores 429 Demasiadas solicitudesSoluciones:
  • Revisa tu uso actual en el panel
  • Implementa un retraso exponencial en tu lógica de reintentos
  • Considera mejorar tu plan para obtener límites más altos
  • Optimiza tus solicitudes para reducir las llamadas innecesarias
Síntomas: errores 403 ProhibidoSoluciones:
  • Verifica que las restricciones de IP no estén bloqueando tus solicitudes
  • Comprueba que tu suscripción incluya acceso al endpoint
  • Asegúrate de que tu clave de API tenga los permisos necesarios

Próximos pasos

Quickstart Guide

Comienza a realizar tus primeras llamadas a la API con Helius

API Reference

Explora todos los endpoints y métodos disponibles

Rate Limits

Comprende los límites de frecuencia y las opciones de mejora

Dashboard

Supervisa el uso de tu API y administra las claves

Soporte

¿Necesitas ayuda con la autenticación o tienes preguntas sobre las claves de API?

Discord Community

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

Email Support

Contacta directamente con nuestro equipo de soporte