¿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 |
Aumenta los límites de frecuencia
Los equipos con planes Professional pueden comprar 100 RPS adicionales por $100 USD 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 |
Las solicitudes
/fast sin clave de Sender están limitadas a 1 solicitud por segundo por IP de salida
y por región. Quienes realizan llamadas detrás del mismo NAT comparten este límite. Las solicitudes 429
rechazadas cuentan para el límite; /ping no cuenta. Agrega la clave de API de tu proyecto de Helius
existente para obtener el límite de 50 solicitudes por segundo, por clave y por región.sendTransaction, contacta a nuestro equipo de ventas.
Los usuarios del plan Professional también pueden solicitar aumentos de los límites de frecuencia y acuerdos personalizados de propinas para Sender a fin de admitir aplicaciones de trading con mayor rendimiento.
Llamadas RPC complejas
| Endpoint | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
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 |
LaserStream
| Recurso | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
| Redes | — | Devnet | Devnet, Mainnet | Devnet, Mainnet |
| Máximo de claves públicas | — | 10M | 10M | 10M |
| Conexiones activas | — | — | 10 | 100 |
Wallet API
La Wallet API sigue los mismos límites de frecuencia que DAS y las API mejoradas. Todos los endpoints comparten estos límites:| Endpoint | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
| Todos los endpoints de Wallet API | 2/s | 10/s | 50/s | 100/s |
Flujos analizados
| Recurso | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
| Conexiones simultáneas | 5 | 10 | 50 | 50 |
| Suscripciones por conexión | 25 | 25 | 25 | 25 |
WebSocket de LaserStream
| Recurso | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
| 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 | Developer | Business | Professional |
|---|---|---|---|---|
| Máximo de webhooks | 5 | 50 | 50 | 50 |
| Direcciones por webhook | 100k | 100k | 100k | 100k |
Compresión ZK
| Servicio | Gratis | Developer | Business | Professional |
|---|---|---|---|---|
| API de Photon | 2/s | 10/s | 50/s | 100/s |
getValidityProof | 1/s | 5/s | 10/s | 20/s |
Reintentos y gestión de errores
Cuando tu aplicación reciba una respuesta429 Too Many Requests, 503 Service Unavailable o una respuesta 5xx transitoria, 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 la espera cada vez que vuelvas a intentarlo, hasta un máximo de 30 segundos.
- Agrega una pequeña variación aleatoria de ±25% a cada espera para que varias aplicaciones no vuelvan a intentarlo al mismo tiempo.
- Desiste después de 5 intentos y devuelve el error al código que realizó la llamada.