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.mdInstala 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 conhelius 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
- Node.js
- Python
- Docker
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
Invalid API Key Error
Invalid API Key Error
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
Rate Limit Exceeded
Rate Limit Exceeded
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
Forbidden Access
Forbidden Access
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