¿Qué son los límites de frecuencia?
Los límites de frecuencia controlan cuántas solicitudes puedes realizar por segundo. Cuando los superes, recibirás una respuesta HTTP 429. Para saber qué hacer cuando recibas un error 429 u otro fallo transitorio, consulta Reintentos y manejo de errores más adelante.
Límites de frecuencia estándar
Tu plan tiene dos grupos de límites de frecuencia estándar: uno para las solicitudes RPC y otro para las solicitudes de la API DAS. Estos son los límites de frecuencia base de cada plan de Helius:
| Plan | Límite de frecuencia de RPC | DAS y API mejoradas |
|---|
| Gratis | 10 solicitudes/s | 2 solicitudes/s |
| Desarrollador | 50 solicitudes/s | 10 solicitudes/s |
| Negocios | 200 solicitudes/s | 50 solicitudes/s |
| Profesional | 500 solicitudes/s | 100 solicitudes/s |
| Empresarial | Personalizado | Personalizado |
Aumentar los límites de frecuencia
Los equipos con planes Profesionales pueden comprar 100 RPS adicionales por $100 al mes.
Si necesitas límites de frecuencia personalizados antes de un lanzamiento, contacta a nuestro equipo de ventas. Si tienes el nivel Desarrollador o Negocios, mejora tu plan para aumentar tus límites de frecuencia.
Límites de frecuencia especiales
Algunos endpoints y productos especializados de Helius tienen límites de frecuencia especiales debido a sus requisitos de procesamiento.
Envío de transacciones
| Endpoint | Gratis | Desarrollador | Negocios | Profesional |
|---|
Sender | 50/s | 50/s | 50/s | 50/s |
sendTransaction | 1/s | 5/s | 50/s | 100/s |
sendBundle | — | — | 5/s | 5/s |
simulateBundle | 10/s | 50/s | 200/s | 500/s |
Si tienes un plan Profesional y necesitas aumentar tus límites de frecuencia de sendTransaction, contacta a nuestro equipo de ventas.
Los usuarios del plan Profesional también pueden solicitar aumentos de los límites de frecuencia y acuerdos personalizados de propinas para que Sender admita aplicaciones de trading con mayor rendimiento.
Llamadas RPC complejas
| Endpoint | Gratis | Desarrollador | Negocios | Profesional |
|---|
getProgramAccounts | 5/s | 25/s | 50/s | 75/s |
Datos históricos
Al realizar solicitudes por lotes para métodos de datos históricos, se aplican los siguientes límites:
| Método | Tamaño máximo del lote |
|---|
getTransaction | 100 elementos por solicitud |
getTransactionsForAddress | No se permiten solicitudes por lotes |
getTransfersByAddress | No se permiten solicitudes por lotes |
| Todos los demás métodos históricos | 10 elementos por solicitud |
Si superas los límites de los lotes, recibirás una respuesta de error. Para getTransactionsForAddress e getTransfersByAddress, debes consultar cada dirección en una solicitud separada.
LaserStream
| Recurso | Gratis | Desarrollador | Negocios | Profesional |
|---|
| Redes | — | Devnet | Devnet, Mainnet | Devnet, Mainnet |
| Máximo de claves públicas | — | 10M | 10M | 10M |
| Conexiones activas | — | — | 10 | 100 |
API de Wallet
La API de Wallet sigue los mismos límites de frecuencia que DAS y las API mejoradas. Todos los endpoints comparten estos límites:
| Endpoint | Gratis | Desarrollador | Negocios | Profesional |
|---|
| Todos los endpoints de la API de Wallet | 2/s | 10/s | 50/s | 100/s |
Esto incluye endpoints de consultas de identidad, saldos, historial, transferencias y fuentes de fondos. Obtén más información en nuestra documentación de la API de Wallet.
WebSocket de LaserStream
| Recurso | Gratis | Desarrollador | Negocios | Profesional |
|---|
| Conexiones simultáneas | 5 | 150 | 250 | 1,000 |
| Suscripciones por conexión | 1,000 | 1,000 | 1,000 | 1,000 |
| Tipos de WebSocket | Estándar | Estándar, mejorado | Estándar, mejorado | Estándar, mejorado |
Webhooks
| Recurso | Gratis | Desarrollador | Negocios | Profesional |
|---|
| Máximo de webhooks | 5 | 50 | 50 | 50 |
| Direcciones por webhook | 100k | 100k | 100k | 100k |
Compresión ZK
| Servicio | Gratis | Desarrollador | Negocios | Profesional |
|---|
| API de Photon | 2/s | 10/s | 50/s | 100/s |
getValidityProof | 1/s | 5/s | 10/s | 20/s |
Reintentos y manejo de errores
Cuando tu aplicación reciba una respuesta 429 Too Many Requests, 503 Service Unavailable o una respuesta transitoria 5xx, espera un momento y vuelve a intentarlo; no lo hagas de inmediato. Los reintentos inmediatos acumulan solicitudes y hacen que la recuperación del límite de frecuencia sea más lenta, no más rápida.
Estrategia recomendada
- Espera aproximadamente 1 segundo antes del primer reintento.
- Duplica el tiempo de espera cada vez que vuelvas a intentarlo, hasta un máximo de 30 segundos.
- Añade una pequeña variación aleatoria de ±25 % a cada espera para que varias aplicaciones no vuelvan a intentarlo al mismo tiempo.
- Abandona después de 5 intentos y devuelve el error al código que realizó la llamada.
Qué errores debes volver a intentar
Ejemplo
Estructura de la respuesta de error
Todas las API de Helius devuelven un cuerpo JSON estructurado cuando se produce un error. Los endpoints JSON-RPC (RPC de Solana, DAS, Sender, Priority Fee y Compresión ZK) devuelven la envoltura estándar JSON-RPC 2.0:
Los endpoints REST (API de Wallet y API de administración) devuelven:
Consulta Códigos de error comunes para ver la lista completa de códigos de error y el significado de cada uno.