Skip to main content

¿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:
PlanLímite de frecuencia de RPCDAS y API mejoradas
Gratis10 solicitudes/s2 solicitudes/s
Desarrollador50 solicitudes/s10 solicitudes/s
Negocios200 solicitudes/s50 solicitudes/s
Profesional500 solicitudes/s100 solicitudes/s
EmpresarialPersonalizadoPersonalizado

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

EndpointGratisDesarrolladorNegociosProfesional
Sender50/s50/s50/s50/s
sendTransaction1/s5/s50/s100/s
sendBundle——5/s5/s
simulateBundle10/s50/s200/s500/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

EndpointGratisDesarrolladorNegociosProfesional
getProgramAccounts5/s25/s50/s75/s

Datos históricos

Al realizar solicitudes por lotes para métodos de datos históricos, se aplican los siguientes límites:
MétodoTamaño máximo del lote
getTransaction100 elementos por solicitud
getTransactionsForAddressNo se permiten solicitudes por lotes
getTransfersByAddressNo se permiten solicitudes por lotes
Todos los demás métodos históricos10 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

RecursoGratisDesarrolladorNegociosProfesional
Redes—DevnetDevnet, MainnetDevnet, Mainnet
Máximo de claves públicas—10M10M10M
Conexiones activas——10100

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:
EndpointGratisDesarrolladorNegociosProfesional
Todos los endpoints de la API de Wallet2/s10/s50/s100/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

RecursoGratisDesarrolladorNegociosProfesional
Conexiones simultáneas51502501,000
Suscripciones por conexión1,0001,0001,0001,000
Tipos de WebSocketEstándarEstándar, mejoradoEstándar, mejoradoEstándar, mejorado

Webhooks

RecursoGratisDesarrolladorNegociosProfesional
Máximo de webhooks5505050
Direcciones por webhook100k100k100k100k

Compresión ZK

ServicioGratisDesarrolladorNegociosProfesional
API de Photon2/s10/s50/s100/s
getValidityProof1/s5/s10/s20/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.